gismap 0.2.2__tar.gz → 0.4.0__tar.gz

{gismap-0.2.2 → gismap-0.4.0}/.github/workflows/build.yml

@@ -34,7 +34,7 @@ jobs:
     - name: Set up uv
       uses: astral-sh/setup-uv@v5
       with:
-        version: "0.8.12"
+        version: "0.9.27"
 
     - name: Run tests
       run: |

{gismap-0.2.2 → gismap-0.4.0}/.github/workflows/docs.yml

@@ -12,7 +12,7 @@ on:
 jobs:
   build-and-deploy:
     runs-on: ubuntu-latest
-    timeout-minutes: 30
+    timeout-minutes: 180
     steps:
 
       - name: Checkout
@@ -29,7 +29,7 @@ jobs:
       - name: Set up uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: "0.8.12"
+          version: "0.9.27"
 
       - name: Setup Pandoc
         uses: pandoc/actions/setup@v1
@@ -39,6 +39,7 @@ jobs:
       - name: Build Sphinx documentation
         run: |
           uv sync --all-extras
+          uv run python -m gismap.build
           uv run sphinx-build -a -E -b html docs build
 
       - name: Deploy Sphinx documentation on Github Pages

gismap-0.4.0/.github/workflows/ldb-build.yml

@@ -0,0 +1,98 @@
+name: Build LDB Database
+
+on:
+  schedule:
+    - cron: '0 2 * * 0'  # Weekly on Sunday 2 AM UTC
+  workflow_dispatch:  # Manual trigger
+
+jobs:
+  build-ldb:
+    name: Build and Upload LDB Database
+    runs-on: ubuntu-latest
+    timeout-minutes: 60  # Build takes ~30 min, allow margin
+    permissions:
+      contents: write  # To upload release assets
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.27"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Build LDB database
+        run: |
+          echo "Building LDB database from DBLP TTL..."
+          uv run python -m gismap.build
+          echo "Build complete."
+
+      - name: Locate and verify database
+        id: locate-db
+        run: |
+          # Find database in platformdirs location
+          DB_PATH=$(uv run python -c "from gismap.sources.ldb import LDB_PATH; print(LDB_PATH)")
+          echo "Database path: $DB_PATH"
+
+          if [ ! -f "$DB_PATH" ]; then
+            echo "ERROR: Database not found at $DB_PATH"
+            exit 1
+          fi
+
+          # Get file size
+          DB_SIZE=$(stat -c%s "$DB_PATH")
+          echo "Database size: $DB_SIZE bytes ($(echo "scale=2; $DB_SIZE / 1073741824" | bc) GB)"
+
+          # Get counts
+          AUTHOR_COUNT=$(uv run python -c "from gismap.sources.ldb import LDB; LDB.load_db(); print(len(LDB.authors))")
+          PUBLI_COUNT=$(uv run python -c "from gismap.sources.ldb import LDB; LDB.load_db(); print(len(LDB.publis))")
+          echo "Authors: $AUTHOR_COUNT, Publications: $PUBLI_COUNT"
+
+          echo "db_path=$DB_PATH" >> $GITHUB_OUTPUT
+          echo "db_size=$DB_SIZE" >> $GITHUB_OUTPUT
+          echo "author_count=$AUTHOR_COUNT" >> $GITHUB_OUTPUT
+          echo "publi_count=$PUBLI_COUNT" >> $GITHUB_OUTPUT
+
+      - name: Find latest release
+        id: latest-release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          LATEST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
+          if [ -z "$LATEST_TAG" ]; then
+            echo "ERROR: No releases found"
+            exit 1
+          fi
+          echo "Latest release: $LATEST_TAG"
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Upload LDB to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Uploading ldb.pkl.zst to release ${{ steps.latest-release.outputs.tag }}..."
+          gh release upload "${{ steps.latest-release.outputs.tag }}" \
+            "${{ steps.locate-db.outputs.db_path }}" \
+            --clobber
+          echo "Upload complete!"
+
+      - name: Summary
+        run: |
+          echo "## LDB Build Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "| Metric | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Release | ${{ steps.latest-release.outputs.tag }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Authors | ${{ steps.locate-db.outputs.author_count }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Publications | ${{ steps.locate-db.outputs.publi_count }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Database Size | $(echo "scale=2; ${{ steps.locate-db.outputs.db_size }} / 1073741824" | bc) GB |" >> $GITHUB_STEP_SUMMARY
+          echo "| Build Date | $(date -u +%Y-%m-%dT%H:%M:%SZ) |" >> $GITHUB_STEP_SUMMARY

gismap-0.4.0/.github/workflows/release.yml

@@ -0,0 +1,77 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish-pypi:
+    name: Publish Python Package
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    environment:
+      name: pypi
+    permissions:
+      id-token: write  # Required for PyPI trusted publishing
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.11"  # Pin to specific uv version
+
+      - name: Build package
+        run: uv build --no-sources  # Recommended for production builds
+
+      - name: Publish to PyPI
+        run: uv publish -v dist/*
+
+  build-ldb:
+    name: Build LDB Database
+    runs-on: ubuntu-latest
+    timeout-minutes: 60  # Build takes ~30 min
+    permissions:
+      contents: write  # To upload release assets
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.11"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Build LDB database
+        run: |
+          echo "Building LDB database from DBLP TTL..."
+          uv run python -m gismap.build
+          echo "Build complete."
+
+      - name: Locate database
+        id: locate-db
+        run: |
+          DB_PATH=$(uv run python -c "from gismap.sources.ldb import LDB_PATH; print(LDB_PATH)")
+          echo "Database path: $DB_PATH"
+          echo "db_path=$DB_PATH" >> $GITHUB_OUTPUT
+
+      - name: Upload LDB to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Uploading ldb.pkl.zst to release ${{ github.event.release.tag_name }}..."
+          gh release upload "${{ github.event.release.tag_name }}" \
+            "${{ steps.locate-db.outputs.db_path }}" \
+            --clobber
+          echo "Upload complete!"

gismap-0.4.0/HISTORY.md

@@ -0,0 +1,69 @@
+# History
+
+## Pipeline
+
+- anHALyze: tools to spot HAL issues (bad author metada, DBLP comparison, widget)
+- EgoConf: find your conferences journals
+- Easier access to graph customization
+- Additional graph option (e.g. time filtering and coloring, default group checks...)
+- Custom CSS (e.g. transparent background)
+- Gismo integration
+
+## 0.4.0 (2026-01-27): Local DB
+
+New DB: LDB (Local DB). All the strengths of DBLP, None of its weaknesses.
+
+- Convert the whole DBLP relational DB into a Gismap compatible local object.
+- Introduces new compressed list format (Zlist) to keep the DB in memory.
+- Use Bag-of-Factors to enable approximate search.
+- You can build your own dataset or just rely on the one we provide and update.
+
+Also, Lamsade added to the gallery.
+
+## 0.3.1 (2025-11-27): Bug fixes
+
+- Fix BS4 dependency issue.
+- Errors in readme
+
+## 0.3.0 (2025-11-25): Bigger, faster, prettier
+
+- VisJS integration has been fully revamped to reduce JS errors and resource consumption.
+- A gallery is now available in the documentation to showcase the possibilities:
+  - Lip6 (Sorbonne university CS lab, single team / whole lab);
+  - Laas (Toulouse university CS lab, single team / whole lab) + Solace (collab team);
+  - Cédric (CNAM, whole CS Lab);
+  - LINCS (legacy Paris-based collaboration project).
+- Binder integration: you can now play with GisMap directly in your browser, no local Python required!
+- A FAQ, because when the developer (me) starts to forget some how-tos, you know it’s time for a FAQ.
+- GisGraphs can now have groups with automatic color selection and a selectable legend.
+- Gradient-based coloring for inter-group edges (that one was no picnic).
+- Lots of minor improvements here and there.
+
+## 0.2.2 (2025-09-08): Various upgrades
+
+- Breaking change: renaming some methods/attributes (e.g. *sun* is now *star* in EgoMap)
+- Graphs now include unconnected non-empty nodes (their display will be an option in the next version)
+- Typos here and there
+- New Lab class: LINCS
+
+## 0.2.1 (2025-09-01): Minor VisJS enhancements
+
+- Better handling of dark/light mode (should be compatible with Pydata, Jupyter, and System).
+- Responsive size
+
+## 0.2.0 (2025-08-31): EgoMaps!
+
+- New lab structure: EgoMap shows the people that revolves around you!
+- New lab method: expansion, which adds *moons* (neighbor researchers).
+- Add filters when building authors and publications.
+- Physic engine changed fo better visualization.
+- Multi-source handling fine-tuned.
+- Better display (size and theme).
+
+
+## 0.1.0 (2025-07-24): First release
+
+- First release on PyPI.
+- Online DBLP and HAL DB implemented.
+- Lab stuctures implemented.
+- Early version of collaboration graph available.

{gismap-0.2.2 → gismap-0.4.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: gismap
-Version: 0.2.2
-Summary: GISMAP leverages DBLP and HAL databases to provide cartography tools for you and your lab.
+Version: 0.4.0
+Summary: GisMap leverages DBLP and HAL databases to provide cartography tools for you and your lab.
 Project-URL: Repository, https://github.com/balouf/gismap
 Project-URL: Documentation, https://balouf.github.io/gismap
 Author-email: Fabien Mathieu <fabien.mathieu@normalesup.org>
@@ -9,9 +9,14 @@ Maintainer-email: Fabien Mathieu <fabien.mathieu@normalesup.org>
 License-Expression: MIT
 License-File: AUTHORS.md
 Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.14.2
 Requires-Dist: bof>=0.3.5
+Requires-Dist: distinctipy>=1.3.4
+Requires-Dist: domonic>=0.9.13
 Requires-Dist: gismo>=0.5.2
 Requires-Dist: ipykernel>=6.30.1
+Requires-Dist: ipywidgets>=8.1.8
+Requires-Dist: platformdirs>=4.5.0
 Requires-Dist: tqdm>=4.67.1
 Description-Content-Type: text/markdown
 
@@ -19,12 +24,13 @@ Description-Content-Type: text/markdown
 
 
 [![PyPI Status](https://img.shields.io/pypi/v/gismap.svg)](https://pypi.python.org/pypi/gismap)
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fbinder%2Finteractive.ipynb)
 [![Build Status](https://github.com/balouf/gismap/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/balouf/gismap/actions?query=workflow%3Abuild)
 [![Documentation Status](https://github.com/balouf/gismap/actions/workflows/docs.yml/badge.svg?branch=main)](https://github.com/balouf/gismap/actions?query=workflow%3Adocs)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code Coverage](https://codecov.io/gh/balouf/gismap/branch/main/graphs/badge.svg)](https://codecov.io/gh/balouf/gismap/tree/main)
 
-GISMAP leverages DBLP and HAL databases to provide cartography tools for you and your lab.
+GisMap leverages DBLP and HAL databases to provide cartography tools for you and your lab.
 
 - Free software: MIT
 - Documentation: <https://balouf.github.io/gismap/>.
@@ -37,25 +43,48 @@ GISMAP leverages DBLP and HAL databases to provide cartography tools for you and
 - Automatically keeps track of a Lab/Department members and publications.
 - Builds interactive collaboration graphs.
 
+## Test GisMap online!
+
+Don't want to install GisMap on your computer (yet)? No worries, you can play with it using https://mybinder.org/.
+
+For example:
+
+- [A simple interface to display and save collaboration graphs](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fbinder%2Finteractive.ipynb)
+- [Tutorial: Making LabMaps](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fdocs%2Ftutorials%2Flab_tutorial.ipynb)
+- [Tutorial: Making EgoMaps](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fdocs%2Ftutorials%2Fegomap.ipynb)
+- [Jupyter Lab instance with GisMap installed](https://mybinder.org/v2/gh/balouf/gismap/HEAD)
+
+
 ## Quickstart
 
-Install GISMAP:
+Install GisMap:
 
 ```console
 $ pip install gismap
 ```
 
-Use GISMAP to produce a collaboration graph (HTML):
+Use GisMap to display a collaboration graph (HTML) from a Notebook:
 
 ```pycon
->>> from gismap.sources.hal import HAL
->>> from gismap.lab import ListLab
->>> lab = ListLab(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
 >>> lab.update_authors()
 >>> lab.update_publis()
 >>> lab.show_html()
 ```
 
+If you are not using Jupyter Lab/Notebook, rich display will not work.
+Instead, save the HTML and display it on your browser:
+
+```pycon
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> lab.update_authors()
+>>> lab.update_publis()
+>>> lab.save_html("my_graph")
+```
+
+
 ## Credits
 
 This package was created with [Cookiecutter][CC] and the [Package Helper 3][PH3] project template.

{gismap-0.2.2 → gismap-0.4.0}/README.md

@@ -2,12 +2,13 @@
 
 
 [![PyPI Status](https://img.shields.io/pypi/v/gismap.svg)](https://pypi.python.org/pypi/gismap)
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fbinder%2Finteractive.ipynb)
 [![Build Status](https://github.com/balouf/gismap/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/balouf/gismap/actions?query=workflow%3Abuild)
 [![Documentation Status](https://github.com/balouf/gismap/actions/workflows/docs.yml/badge.svg?branch=main)](https://github.com/balouf/gismap/actions?query=workflow%3Adocs)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code Coverage](https://codecov.io/gh/balouf/gismap/branch/main/graphs/badge.svg)](https://codecov.io/gh/balouf/gismap/tree/main)
 
-GISMAP leverages DBLP and HAL databases to provide cartography tools for you and your lab.
+GisMap leverages DBLP and HAL databases to provide cartography tools for you and your lab.
 
 - Free software: MIT
 - Documentation: <https://balouf.github.io/gismap/>.
@@ -20,25 +21,48 @@ GISMAP leverages DBLP and HAL databases to provide cartography tools for you and
 - Automatically keeps track of a Lab/Department members and publications.
 - Builds interactive collaboration graphs.
 
+## Test GisMap online!
+
+Don't want to install GisMap on your computer (yet)? No worries, you can play with it using https://mybinder.org/.
+
+For example:
+
+- [A simple interface to display and save collaboration graphs](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fbinder%2Finteractive.ipynb)
+- [Tutorial: Making LabMaps](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fdocs%2Ftutorials%2Flab_tutorial.ipynb)
+- [Tutorial: Making EgoMaps](https://mybinder.org/v2/gh/balouf/gismap/HEAD?urlpath=%2Fdoc%2Ftree%2Fdocs%2Ftutorials%2Fegomap.ipynb)
+- [Jupyter Lab instance with GisMap installed](https://mybinder.org/v2/gh/balouf/gismap/HEAD)
+
+
 ## Quickstart
 
-Install GISMAP:
+Install GisMap:
 
 ```console
 $ pip install gismap
 ```
 
-Use GISMAP to produce a collaboration graph (HTML):
+Use GisMap to display a collaboration graph (HTML) from a Notebook:
 
 ```pycon
->>> from gismap.sources.hal import HAL
->>> from gismap.lab import ListLab
->>> lab = ListLab(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
 >>> lab.update_authors()
 >>> lab.update_publis()
 >>> lab.show_html()
 ```
 
+If you are not using Jupyter Lab/Notebook, rich display will not work.
+Instead, save the HTML and display it on your browser:
+
+```pycon
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> lab.update_authors()
+>>> lab.update_publis()
+>>> lab.save_html("my_graph")
+```
+
+
 ## Credits
 
 This package was created with [Cookiecutter][CC] and the [Package Helper 3][PH3] project template.

gismap-0.4.0/binder/interactive.ipynb

@@ -0,0 +1,63 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "0",
+   "metadata": {},
+   "source": [
+    "# Interactive collaboration graphs"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from gismap import GismapWidget\n",
+    "\n",
+    "gs = GismapWidget()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2",
+   "metadata": {},
+   "source": [
+    "You can use this notebook to quickly test LabMaps and EgoMaps:\n",
+    "\n",
+    "- Enter one name for an EgoMap, comma-separated names for a LabMap;\n",
+    "- Choose your DB:\n",
+    "  - HAL for French researchers (fast DB);\n",
+    "  - DBLP for CS researchers (slow DB);\n",
+    "- The size slider will complete your map with *moons* if necessary and feasible.\n",
+    "\n",
+    "You can save the result!\n",
+    "\n",
+    "Just execute the cell above to proceed."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

gismap-0.4.0/binder/postBuild

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -ex
+
+# Create gismap data directory (Linux path from platformdirs)
+mkdir -p ~/.local/share/gismap
+
+# Download LDB from the pinned release
+# UPDATE THIS URL when releasing new versions
+LDB_URL="https://github.com/balouf/gismap/releases/download/v0.4.0/ldb.pkl.zst"
+
+echo "Downloading LDB database for Binder image..."
+curl -L -o ~/.local/share/gismap/ldb.pkl.zst "$LDB_URL"
+
+# Verify download
+if [ ! -f ~/.local/share/gismap/ldb.pkl.zst ]; then
+    echo "ERROR: Failed to download ldb.pkl.zst"
+    exit 1
+fi
+
+ls -lh ~/.local/share/gismap/ldb.pkl.zst
+echo "LDB database successfully embedded in Binder image"

gismap-0.4.0/binder/requirements.txt

@@ -0,0 +1 @@
+git+https://github.com/balouf/gismap.git@v0.4.0#egg=gismap

gismap-0.4.0/binder/runtime.txt

@@ -0,0 +1 @@
+python-3.12