Skip to content

Examples as rendered notebooks + neural ACNet example#7

Merged
thisiscam merged 1 commit into
mainfrom
example-notebooks
May 24, 2026
Merged

Examples as rendered notebooks + neural ACNet example#7
thisiscam merged 1 commit into
mainfrom
example-notebooks

Conversation

@thisiscam

Copy link
Copy Markdown
Owner

Per request: examples become rendered Jupyter notebooks (step-by-step), shown in the docs site, plus a new neural (ACNet) example.

  • 5 notebooks in docs/examples/, rendered via mkdocs-jupyter (committed pre-run outputs, no execution at build time):
    1. Two-level copula (quickstart) · 2. Fitting by MLE · 3. Censored survival · 4. Sampling & visualization · 5. Neural generator (ACNet)
  • ACNet notebook: a learnable Archimedean generator (softmax-weighted mixture of exponentials) fit end-to-end through the exact Bell density with jax.grad. On synthetic $d=5$ Clayton data it reaches mean LL 2.86 vs the true-Clayton ceiling 3.06 (independence = 0), and recovers a generator matching Clayton's — with no parametric form assumed.
  • Each notebook has markdown explanation cells.
  • Removed the old examples/*.py, static examples.md, and redundant PNGs (figures now embedded in notebook 4).
  • mkdocs-jupyter added to the docs extra; nav lists the notebooks.

mkdocs build --strict clean; llms.txt still generated; all notebooks pre-executed (JAX_PLATFORMS=cpu).

Convert the example scripts into step-by-step Jupyter notebooks rendered in
the docs site via mkdocs-jupyter (execute=false: committed, pre-run outputs).

- docs/examples/*.ipynb (5): two-level copula, MLE fitting, censored survival,
  sampling & visualization, and a NEW neural-generator example — an ACNet
  (tensor-network mixture of exponentials) fit end-to-end through the Bell
  density (reaches mean LL 2.86 vs the true-Clayton ceiling 3.06 on synthetic
  d=5 data; independence = 0). Each notebook has markdown explanation cells.
- mkdocs.yml: add mkdocs-jupyter; nav Examples lists the 5 notebooks.
- Remove the old examples/*.py scripts, examples/README.md, the static
  docs/examples.md, and the now-redundant tree/pair PNGs (figures are embedded
  in notebook 04).
- pyproject: add mkdocs-jupyter to the docs extra. README/index/quickstart
  point at the rendered notebooks.

All notebooks pre-executed with JAX_PLATFORMS=cpu; `mkdocs build --strict`
clean; llms.txt still generated.
@thisiscam
thisiscam merged commit 7b4de93 into main May 24, 2026
2 checks passed
@thisiscam
thisiscam deleted the example-notebooks branch May 24, 2026 23:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant