Merge pull request #180 from acgetchell/release/v0.1.0

chore(release): release v0.1.0

Author: acgetchell

CHANGELOG.md

@@ -2,7 +2,7 @@ cff-version: 1.2.0
 message: "If you use this software, please cite it as below."
 type: software
 title: "causal-triangulations: A Causal Dynamical Triangulation library for quantum gravity research"
-version: 0.0.1
+version: 0.1.0
 url: "https://github.com/acgetchell/causal-triangulations"
 repository-code: "https://github.com/acgetchell/causal-triangulations"
 authors:

CITATION.cff

@@ -1,6 +1,6 @@
 [package]
 name = "causal-triangulations"
-version = "0.0.1"
+version = "0.1.0"
 authors = [ "Adam Getchell <adam@adamgetchell.org>" ]
 categories = [ "science", "mathematics", "algorithms", "simulation" ]
 edition = "2024"

Cargo.lock

@@ -37,9 +37,8 @@ See [CHANGELOG.md](CHANGELOG.md) for release history.
 
 ## 🚧 Project Status
 
-🚧 **v0.1.0 release-readiness** — The validated 1+1 CDT foundation is in place, including toroidal volume-changing moves, nonuniform initial volume
-profiles, upstream-backed MCMC sampler mechanics, and CI-aligned validation tooling. The crate remains unreleased at v0.1.0 until the release PR merges and the
-v0.1.0 package and tag are cut.
+**v0.1.0 foundation release** — The validated 1+1 CDT foundation is in place, including toroidal volume-changing moves, nonuniform initial volume profiles,
+upstream-backed MCMC sampler mechanics, trace/summary exports, resumable checkpoints, and CI-aligned validation tooling.
 
 The library currently supports validated 1+1 CDT construction, foliation checks, Metropolis sampling, resumable checkpoints, and core observables.
 Higher-dimensional CDT support, visualization/export workflows, and advanced ensemble-analysis helpers remain roadmap work.
@@ -48,7 +47,7 @@ See [`docs/roadmap.md`](docs/roadmap.md) for current direction, near-term candid
 
 ## ⚙️ Requirements
 
-- Rust 1.95 or newer (required by dependencies such as `delaunay` and `la-stack`)
+- Rust 1.96.0 or newer (pinned by `Cargo.toml` and `rust-toolchain.toml`)
 
 **Why Rust for CDT?**
 

Cargo.toml

@@ -40,8 +40,8 @@ The `cdt` binary accepts various command-line arguments to configure and run CDT
 
 ### Physics Parameters
 
-- `--coupling-0 <κ₀>`: Coupling constant for vertices (default: 1.0)
-- `--coupling-2 <κ₂>`: Coupling constant for triangles (default: 1.0)
+- `--coupling-0 <κ₀>`: Coupling constant for vertices (default: 0.0)
+- `--coupling-2 <κ₂>`: Coupling constant for triangles (default: 0.0)
 - `--cosmological-constant <λ>`: Edge-count cosmological constant (default: `(2 / 3) ln 2`)
 
 ### Additional Options
@@ -271,9 +271,16 @@ RUST_LOG=warn ./target/release/cdt --vertices-per-slice 5 --timeslices 10 --simu
 ### Data Analysis
 
 ```bash
-# Pipe triangulation-only output to analysis tools
-./target/release/cdt --vertices-per-slice 5 --timeslices 10 | \
-  python analysis_script.py
+# Write stable interchange files for dataframe or notebook tools
+./target/release/cdt \
+  --vertices-per-slice 5 \
+  --timeslices 10 \
+  --steps 200 \
+  --thermalization-steps 20 \
+  --measurement-frequency 10 \
+  --simulate \
+  --output-csv trace.csv \
+  --output-json summary.json
 ```
 
 ### Automation

README.md

@@ -61,6 +61,12 @@ polish that are useful but not required for the first DOI-backed foundation rele
 - Add λ scan utilities for unfixed-volume 1+1 CDT runs
   ([#143](https://github.com/acgetchell/causal-triangulations/issues/143)). These should help users tune the cosmological constant, which is conjugate to the
   lattice volume term and controls volume growth or shrinkage in unfixed-volume runs.
+- Add a Polars notebook workflow for CDT analysis caches
+  ([#176](https://github.com/acgetchell/causal-triangulations/issues/176)). This should show how to load the v0.1.0 CSV/JSON outputs, reshape volume-profile
+  data for exploratory analysis, and cache local Parquet files without adding plotting or Parquet dependencies to the Rust crate.
+- Ship prebuilt `cdt` release binaries
+  ([#169](https://github.com/acgetchell/causal-triangulations/issues/169)). This should make the command-line tool easier to try after the first source and
+  crates.io release, while keeping `cargo install` and local release builds supported.
 - Adopt the upstream lift-aware simplex barycenter helper once `delaunay#420` ships
   ([#147](https://github.com/acgetchell/causal-triangulations/issues/147)). This should replace the local `(1,3)` insertion-point policy while preserving the
   existing k=1 flip delegation, and is dependency-gated cleanup for move-kernel geometry ownership rather than a new CDT ensemble.

docs/CLI_EXAMPLES.md

@@ -18,7 +18,7 @@ This directory contains shell scripts that demonstrate how to use the `cdt` comm
 **What it does**:
 
 - Builds the cdt binary in release mode
-- Builds a 10-vertex, 5-timeslice command with 1000 requested MC steps
+- Builds a 4-vertices-per-slice, 5-timeslice command with 1000 requested MC steps
 - Shows logging output for a short `--simulate` run
 
 **Use this for**: First-time testing, verifying installation
@@ -100,7 +100,7 @@ Each script has configuration variables at the top that you can easily modify:
 
 ```bash
 # Edit the simulation parameters in the script
-VERTICES=10
+VERTICES_PER_SLICE=4
 TIMESLICES=5
 STEPS=1000
 TEMPERATURE=1.0
@@ -111,7 +111,7 @@ TEMPERATURE=1.0
 ```bash
 # Modify temperature range or fixed parameters
 TEMPERATURES=(0.5 0.8 1.0 1.2 1.5 2.0 2.5 3.0)
-VERTICES=20
+VERTICES_PER_SLICE=4
 TIMESLICES=8
 STEPS=2000
 ```
@@ -142,7 +142,7 @@ echo "=== Custom CDT Script ==="
 # Build the binary
 cargo build --release
 
-# Run with custom parameters. Remove --simulate for a successful triangulation-only run.
+# Run with custom parameters. Remove --simulate when you only want triangulation construction.
 RUST_LOG=info ./target/release/cdt \
     --vertices-per-slice 4 \
     --timeslices 10 \