Sync with FEM on Colab website: fem-on-colab/fem-on-colab.github.io@f4fce9f1

Author: francesco-ballarin

Diff for: .github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
       - uses: actions/checkout@v4
       - name: Install dependencies
         run: |
-          python3 -m pip -q install yamllint
+          python3 -m pip install --break-system-packages -q yamllint
       - name: Run yamllint
         run: |
           python3 -m yamllint -d "{extends: default, rules: {document-start: {present: false}, line-length: disable, truthy: {check-keys: false}}}" .

Diff for: .github/workflows/stats.yml

@@ -22,9 +22,9 @@ jobs:
       - name: Install dependencies
         run: |
           wget https://github.com/fem-on-colab/release-download-count-script/raw/main/scripts/requirements.txt
-          python3 -m pip -q install -r requirements.txt
+          python3 -m pip install --break-system-packages -q -r requirements.txt
           rm requirements.txt
-          python3 -m pip -q install pandas
+          python3 -m pip install --break-system-packages -q pandas
           SITE_PACKAGES=$(python3 -c 'import site; print(site.getsitepackages()[0])')
           sudo wget https://github.com/fem-on-colab/release-download-count-script/raw/main/scripts/release_download_count.py -P $SITE_PACKAGES
       - name: Update release download stats

Diff for: .github/workflows/website.yml

@@ -35,7 +35,7 @@ jobs:
           path: _build/html
       - name: Install dependencies
         run: |
-          pip3 -q install pandas plotly sphinx-material
+          python3 -m pip install --break-system-packages -q pandas plotly sphinx-material
       - name: Generate sphinx website
         run: |
           pushd _stats

Diff for: _ext/ext.py

@@ -211,7 +211,7 @@ def _library_image(library):
             logo = "_static/images/occ-logo.png"
         elif library == "petsc4py":
             logo = "_static/images/petsc4py-logo.png"
-        elif library == "pybind11" or library.startswith("pybind11 ("):
+        elif library == "pybind11" or library.startswith("pybind11 & nanobind ("):
             logo = "_static/images/pybind11-logo.png"
         elif library == "RBniCS":
             logo = "_static/images/rbnics-logo.png"
@@ -226,6 +226,17 @@ def _library_image(library):
 class Stats(Directive):
 
     def run(self):
+        def get_week_representation(day: datetime.date) -> str:
+            """
+            Get the week representation year-week number.
+
+            Uses day.isocalendar() rather than day.strftime("%Y-%W") to prevent
+            wrong identification of the (week number, year) pair on the first week
+            of the year, see the documentation of datetime.date.isocalendar().
+            """
+            isocalendar_tuple = day.isocalendar()
+            return f"{isocalendar_tuple.year}-{isocalendar_tuple.week}"
+
         # Get release download stats from file, and convert it to a plot
         stats = pd.read_csv("_stats/stats.csv")
         first_day = None
@@ -237,13 +248,13 @@ def run(self):
                     first_day = day
                 else:
                     first_day = min(first_day, day)
-                week = day.strftime("%Y-%W")
+                week = get_week_representation(day)
                 if week not in week_to_headers:
                     week_to_headers[week] = list()
                 week_to_headers[week].append(header)
         weeks = pd.date_range(
             start=first_day - timedelta(days=first_day.weekday()), end=datetime.now(), freq="W-MON").tolist()[:-1]
-        weeks_str = [week.strftime("%Y-%W") for week in weeks]
+        weeks_str = [get_week_representation(week) for week in weeks]
         weekly_stats = pd.DataFrame(0, columns=list(packages.keys()), index=weeks_str)
         for package in weekly_stats.columns:
             condition = stats.package.str.fullmatch(package)
@@ -253,18 +264,25 @@ def run(self):
                     weekly_stats.loc[week, package] = max(stats_package[header] for header in headers)
         if len(weeks) > 1:
             fig = go.Figure()
+            max_downloads = 0
             for package in weekly_stats.columns:
                 weekly_stats_package = weekly_stats[package]
+                weekly_stats_package_diff = weekly_stats_package.diff().to_numpy()
                 fig.add_scatter(
-                    x=weeks[1:], y=np.diff(weekly_stats_package), mode="lines+markers",
+                    x=weeks[1:], y=weekly_stats_package_diff, mode="lines+markers",
                     name=packages[package]["title"])
+                if len(weeks) > 13:
+                    max_downloads = max(max_downloads, np.max(weekly_stats_package_diff[-14:]))
+                else:
+                    max_downloads = max(max_downloads, np.max(weekly_stats_package_diff))
             milliseconds_in_one_week = 604800000
             fig.update_xaxes(tickformat="%Y-%W", dtick=milliseconds_in_one_week)
             if len(weeks) > 13:
                 fig.update_xaxes(
                     tick0=weeks[-14], range=[weeks[-14] - timedelta(days=3), weeks[-1] + timedelta(days=3)])
             else:
                 fig.update_xaxes(tick0=weeks[0])
+            fig.update_yaxes(tick0=- 0.1 * max_downloads, range=[- 0.1 * max_downloads, 1.1 * max_downloads])
             html_buffer = io.StringIO()
             fig.write_html(html_buffer, full_html=False)
             return [nodes.raw(text=html_buffer.getvalue(), format="html")]
@@ -275,22 +293,22 @@ def on_build_finished(app, exc):
     if exc is None and app.builder.format == "html":
         # Unescape at symbol
         subprocess.run(
-            "find " + str(app.outdir) + " -type f -not -path '*/\.git/*' -exec sed -i 's/%40/@/g' {} +",
+            "find " + str(app.outdir) + r" -type f -not -path '*/\.git/*' -exec sed -i 's/%40/@/g' {} +",
             shell=True)
         subprocess.run(  # undo incorrect escape in plotly js
             "sed -i 's/t@0=/t%400=/g' " + str(app.outdir) + "/packages.html",
             shell=True)
         # Mark current page as active
         subprocess.run(
-            "find " + str(app.outdir) + " -type f -not -path '*/\.git/*' -exec sed -i 's/"
+            "find " + str(app.outdir) + r" -type f -not -path '*/\.git/*' -exec sed -i 's/"
             + '<li class="md-tabs__item"><a href="#" class="md-tabs__link">'
             + "/"
             + '<li class="md-tabs__item md-tabs__item_current"><a href="#" class="md-tabs__link">'
             + "/g' {} +",
             shell=True)
         # Disable going to submenus on mobile
         subprocess.run(
-            "find " + str(app.outdir) + " -type f -not -path '*/\.git/*' -exec sed -i 's/"
+            "find " + str(app.outdir) + r" -type f -not -path '*/\.git/*' -exec sed -i 's/"
             + 'id="__toc"'
             + "/"
             + 'id="__toc_disabled"'

Diff for: _ext/packages.py

@@ -165,16 +165,16 @@
         },
     },
     "pybind11": {
-        "title": "pybind11",
+        "title": "pybind11 & nanobind",
         "installation": """
 !wget "https://fem-on-kaggle.github.io/releases/pybind11-install.sh" -O "/tmp/pybind11-install.sh" && bash "/tmp/pybind11-install.sh"
 import pybind11
 """,
         "installation_suffixes": [""],
         "tests": {
-            "pybind11 (with default compiler)": "pybind11/test-none.ipynb",
-            "pybind11 (exporting g++ compiler)": "pybind11/test-gpp.ipynb",
-            "pybind11 (exporting mpicxx compiler)": "pybind11/test-mpicxx.ipynb",
+            "pybind11 & nanobind (with default compiler)": "pybind11/test-none.ipynb",
+            "pybind11 & nanobind (exporting g++ compiler)": "pybind11/test-gpp.ipynb",
+            "pybind11 & nanobind (exporting mpicxx compiler)": "pybind11/test-mpicxx.ipynb",
         },
     },
     "slepc4py": {