Add jupyter notebook demonstrating voc4cat use

Author: dalito

demo/README.md

@@ -0,0 +1,27 @@
+# Voc4Cat Demo Notebook
+
+Interactive Jupyter notebook showing how to download, query, and visualize the
+[Voc4Cat](https://w3id.org/nfdi4cat/voc4cat) SKOS vocabulary with Python.
+
+## Local Setup with uv
+
+```bash
+# Create a virtual environment and install dependencies
+uv venv
+source .venv/bin/activate   # Linux/macOS
+.venv\Scripts\activate       # Windows
+
+uv pip install -r requirements.txt
+
+# Start Jupyter
+jupyter notebook explore-voc4cat.ipynb
+```
+
+## Updating dependencies
+
+`requirements.in` lists the direct dependencies.
+To regenerate the pinned `requirements.txt`:
+
+```bash
+uv pip compile --upgrade requirements.in -o requirements.txt
+```

demo/explore-voc4cat.ipynb

@@ -0,0 +1,6 @@
+# Compile to requirements.txt with `pip-compile --upgrade requirements.in`
+# With uv: `uv pip compile --upgrade requirements.in -o requirements.txt`
+jupyter
+rdflib>=7.0
+networkx>=3.0
+matplotlib>=3.7

demo/requirements.in

@@ -0,0 +1,338 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile requirements.in -o requirements.txt
+anyio==4.12.1
+    # via
+    #   httpx
+    #   jupyter-server
+argon2-cffi==25.1.0
+    # via jupyter-server
+argon2-cffi-bindings==25.1.0
+    # via argon2-cffi
+arrow==1.4.0
+    # via isoduration
+asttokens==3.0.1
+    # via stack-data
+async-lru==2.2.0
+    # via jupyterlab
+attrs==25.4.0
+    # via
+    #   jsonschema
+    #   referencing
+babel==2.18.0
+    # via jupyterlab-server
+beautifulsoup4==4.14.3
+    # via nbconvert
+bleach==6.3.0
+    # via nbconvert
+certifi==2026.1.4
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+cffi==2.0.0
+    # via argon2-cffi-bindings
+charset-normalizer==3.4.4
+    # via requests
+colorama==0.4.6
+    # via ipython
+comm==0.2.3
+    # via
+    #   ipykernel
+    #   ipywidgets
+contourpy==1.3.3
+    # via matplotlib
+cycler==0.12.1
+    # via matplotlib
+debugpy==1.8.20
+    # via ipykernel
+decorator==5.2.1
+    # via ipython
+defusedxml==0.7.1
+    # via nbconvert
+executing==2.2.1
+    # via stack-data
+fastjsonschema==2.21.2
+    # via nbformat
+fonttools==4.61.1
+    # via matplotlib
+fqdn==1.5.1
+    # via jsonschema
+h11==0.16.0
+    # via httpcore
+httpcore==1.0.9
+    # via httpx
+httpx==0.28.1
+    # via jupyterlab
+idna==3.11
+    # via
+    #   anyio
+    #   httpx
+    #   jsonschema
+    #   requests
+ipykernel==7.2.0
+    # via
+    #   jupyter
+    #   jupyter-console
+    #   jupyterlab
+ipython==9.10.0
+    # via
+    #   ipykernel
+    #   ipywidgets
+    #   jupyter-console
+ipython-pygments-lexers==1.1.1
+    # via ipython
+ipywidgets==8.1.8
+    # via jupyter
+isoduration==20.11.0
+    # via jsonschema
+jedi==0.19.2
+    # via ipython
+jinja2==3.1.6
+    # via
+    #   jupyter-server
+    #   jupyterlab
+    #   jupyterlab-server
+    #   nbconvert
+json5==0.13.0
+    # via jupyterlab-server
+jsonpointer==3.0.0
+    # via jsonschema
+jsonschema==4.26.0
+    # via
+    #   jupyter-events
+    #   jupyterlab-server
+    #   nbformat
+jsonschema-specifications==2025.9.1
+    # via jsonschema
+jupyter==1.1.1
+    # via -r requirements.in
+jupyter-client==8.8.0
+    # via
+    #   ipykernel
+    #   jupyter-console
+    #   jupyter-server
+    #   nbclient
+jupyter-console==6.6.3
+    # via jupyter
+jupyter-core==5.9.1
+    # via
+    #   ipykernel
+    #   jupyter-client
+    #   jupyter-console
+    #   jupyter-server
+    #   jupyterlab
+    #   nbclient
+    #   nbconvert
+    #   nbformat
+jupyter-events==0.12.0
+    # via jupyter-server
+jupyter-lsp==2.3.0
+    # via jupyterlab
+jupyter-server==2.17.0
+    # via
+    #   jupyter-lsp
+    #   jupyterlab
+    #   jupyterlab-server
+    #   notebook
+    #   notebook-shim
+jupyter-server-terminals==0.5.4
+    # via jupyter-server
+jupyterlab==4.5.5
+    # via
+    #   jupyter
+    #   notebook
+jupyterlab-pygments==0.3.0
+    # via nbconvert
+jupyterlab-server==2.28.0
+    # via
+    #   jupyterlab
+    #   notebook
+jupyterlab-widgets==3.0.16
+    # via ipywidgets
+kiwisolver==1.4.9
+    # via matplotlib
+lark==1.3.1
+    # via rfc3987-syntax
+markupsafe==3.0.3
+    # via
+    #   jinja2
+    #   nbconvert
+matplotlib==3.10.8
+    # via -r requirements.in
+matplotlib-inline==0.2.1
+    # via
+    #   ipykernel
+    #   ipython
+mistune==3.2.0
+    # via nbconvert
+nbclient==0.10.4
+    # via nbconvert
+nbconvert==7.17.0
+    # via
+    #   jupyter
+    #   jupyter-server
+nbformat==5.10.4
+    # via
+    #   jupyter-server
+    #   nbclient
+    #   nbconvert
+nest-asyncio==1.6.0
+    # via ipykernel
+networkx==3.6.1
+    # via -r requirements.in
+notebook==7.5.3
+    # via jupyter
+notebook-shim==0.2.4
+    # via
+    #   jupyterlab
+    #   notebook
+numpy==2.4.2
+    # via
+    #   contourpy
+    #   matplotlib
+packaging==26.0
+    # via
+    #   ipykernel
+    #   jupyter-events
+    #   jupyter-server
+    #   jupyterlab
+    #   jupyterlab-server
+    #   matplotlib
+    #   nbconvert
+pandocfilters==1.5.1
+    # via nbconvert
+parso==0.8.6
+    # via jedi
+pillow==12.1.1
+    # via matplotlib
+platformdirs==4.9.2
+    # via jupyter-core
+prometheus-client==0.24.1
+    # via jupyter-server
+prompt-toolkit==3.0.52
+    # via
+    #   ipython
+    #   jupyter-console
+psutil==7.2.2
+    # via ipykernel
+pure-eval==0.2.3
+    # via stack-data
+pycparser==3.0
+    # via cffi
+pygments==2.19.2
+    # via
+    #   ipython
+    #   ipython-pygments-lexers
+    #   jupyter-console
+    #   nbconvert
+pyparsing==3.3.2
+    # via
+    #   matplotlib
+    #   rdflib
+python-dateutil==2.9.0.post0
+    # via
+    #   arrow
+    #   jupyter-client
+    #   matplotlib
+python-json-logger==4.0.0
+    # via jupyter-events
+pywinpty==3.0.3
+    # via
+    #   jupyter-server
+    #   jupyter-server-terminals
+    #   terminado
+pyyaml==6.0.3
+    # via jupyter-events
+pyzmq==27.1.0
+    # via
+    #   ipykernel
+    #   jupyter-client
+    #   jupyter-console
+    #   jupyter-server
+rdflib==7.6.0
+    # via -r requirements.in
+referencing==0.37.0
+    # via
+    #   jsonschema
+    #   jsonschema-specifications
+    #   jupyter-events
+requests==2.32.5
+    # via jupyterlab-server
+rfc3339-validator==0.1.4
+    # via
+    #   jsonschema
+    #   jupyter-events
+rfc3986-validator==0.1.1
+    # via
+    #   jsonschema
+    #   jupyter-events
+rfc3987-syntax==1.1.0
+    # via jsonschema
+rpds-py==0.30.0
+    # via
+    #   jsonschema
+    #   referencing
+send2trash==2.1.0
+    # via jupyter-server
+setuptools==82.0.0
+    # via jupyterlab
+six==1.17.0
+    # via
+    #   python-dateutil
+    #   rfc3339-validator
+soupsieve==2.8.3
+    # via beautifulsoup4
+stack-data==0.6.3
+    # via ipython
+terminado==0.18.1
+    # via
+    #   jupyter-server
+    #   jupyter-server-terminals
+tinycss2==1.4.0
+    # via bleach
+tornado==6.5.4
+    # via
+    #   ipykernel
+    #   jupyter-client
+    #   jupyter-server
+    #   jupyterlab
+    #   notebook
+    #   terminado
+traitlets==5.14.3
+    # via
+    #   ipykernel
+    #   ipython
+    #   ipywidgets
+    #   jupyter-client
+    #   jupyter-console
+    #   jupyter-core
+    #   jupyter-events
+    #   jupyter-server
+    #   jupyterlab
+    #   matplotlib-inline
+    #   nbclient
+    #   nbconvert
+    #   nbformat
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   beautifulsoup4
+    #   referencing
+tzdata==2025.3
+    # via arrow
+uri-template==1.3.0
+    # via jsonschema
+urllib3==2.6.3
+    # via requests
+wcwidth==0.6.0
+    # via prompt-toolkit
+webcolors==25.10.0
+    # via jsonschema
+webencodings==0.5.1
+    # via
+    #   bleach
+    #   tinycss2
+websocket-client==1.9.0
+    # via jupyter-server
+widgetsnbextension==4.0.15
+    # via ipywidgets