Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**Gaussian random fields, persistent homology, and reproducible multi-model mathematical research.**

[![CI](https://github.com/d6g8k5htny-coder/main/actions/workflows/ci.yml/badge.svg)](https://github.com/d6g8k5htny-coder/main/actions/workflows/ci.yml)
[![Landing checks](https://github.com/d6g8k5htny-coder/main/actions/workflows/workspace-landing.yml/badge.svg?branch=main)](https://github.com/d6g8k5htny-coder/main/actions/workflows/workspace-landing.yml)
[![Navigation](https://github.com/d6g8k5htny-coder/main/actions/workflows/navigation.yml/badge.svg)](https://github.com/d6g8k5htny-coder/main/actions/workflows/navigation.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

Expand All @@ -14,6 +14,8 @@ This is the **single public front door** for the Universal Law research program.

The static app is live on main's GitHub Pages, published from `main` / `docs`. See the [deployment and review settings record](docs/PUBLIC_SHOP_SETUP.md). All views preserve scoped ACCEPT, AMEND/open, and engineering-only distinctions. They cannot change scientific status.

**Quick browser demo:** [Open the SIDE24 notebook in Colab](https://colab.research.google.com/github/d6g8k5htny-coder/main/blob/main/docs/notebooks/SIDE24_PUBLIC_COEFFICIENTS.ipynb), then choose **Runtime → Run all**. Read the verified source identity and exact coefficient endpoints for dimensions 2 and 3; the optional chart is **NON-CERTIFYING**. You need no local checkout or installation. The [notebook guide](docs/notebooks/README.md) also explains local setup and dependencies.

## Public source path

For a stranger who wants the landed mathematics rather than the live agent queue, use this order:
Expand All @@ -34,6 +36,8 @@ For a stranger who wants the landed mathematics rather than the live agent queue

For byte identity, use the [public source inventory](docs/public-math/sources.json): its 2,138 frozen source rows are split across the linked JSON pages, and every row records a GitHub repository, path, 40-character commit, Git blob, byte count, and SHA-256. The inventory excludes sandbox, quarantine, and personal paths and is an availability/custody index, not an acceptance register.

**Recovered historical falsifiers:** the [STAGE_E source packet](https://github.com/d6g8k5htny-coder/Math-/blob/a2c3657c3115853a9bd8642b78c3f9ca0bbc59d1/imports/upper2d_stage_e_20260926/README.md) preserves 11 exact files, a reproduced finite H4-JC counterexample, and a source-bound review of numerical defects. Its original certification labels are historical text; the packet does not establish Gaussian continuum or Palm claims. This additive recovery is separate from the frozen inventory above.

**Open draft PRs are visible research/review material, but they are not default-branch mathematics.** Do not treat an AMEND draft, review branch, or custody PR as landed proof merely because GitHub can display it.

## Current status
Expand Down
39 changes: 38 additions & 1 deletion docs/notebooks/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,47 @@

[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/d6g8k5htny-coder/main/blob/main/docs/notebooks/SIDE24_PUBLIC_COEFFICIENTS.ipynb)

Open [SIDE24_PUBLIC_COEFFICIENTS.ipynb](SIDE24_PUBLIC_COEFFICIENTS.ipynb) on GitHub or in Colab, then run the cells in order. It fetches one public JSON file at a fixed 40-character Math- commit and verifies its size and SHA256 before parsing.
## Quick start in your browser

1. [Read the saved notebook output on GitHub](SIDE24_PUBLIC_COEFFICIENTS.ipynb), or use **Open in Colab** above to run it without a local installation.
2. In Colab, choose **Runtime → Run all** and follow any connection prompt. Runtime startup and the source download can take time.
3. Check the printed source commit, byte count and SHA256, then read the exact coefficient endpoints for dimensions 2 and 3. The optional chart follows the table.

The notebook fetches one public JSON file at a fixed 40-character Math- commit and verifies its size and SHA256 before parsing. A fresh run needs internet access to `raw.githubusercontent.com`; a fetch or identity failure stops the run.

The notebook preserves the published decimal endpoint strings and original `scientific_acceptance: false`. Its optional two-bar chart uses approximate midpoints and is **NON-CERTIFYING**. No random field or lifetime solver runs, and the notebook cannot change repository status. The exact table needs only Python's standard library; the chart uses Matplotlib if available.

## Run locally

Use Python 3.11 or later. The notebook's dependency groups are:

| Part | Dependencies |
|---|---|
| Fetch, hash verification and exact table | Python standard library: `hashlib`, `json`, `urllib.request`, `decimal` |
| Local notebook interface | JupyterLab and its installed dependencies |
| Optional approximate chart | Matplotlib and its installed dependencies; the notebook skips the chart when Matplotlib is absent |

From the root of a checkout of this `main` repository, create a separate environment. These commands use a macOS/Linux shell and put the environment beside the checkout:

```sh
python3 -m venv ../universal-law-notebook-env
. ../universal-law-notebook-env/bin/activate
python -m pip install jupyterlab
python -m jupyterlab docs/notebooks/SIDE24_PUBLIC_COEFFICIENTS.ipynb
```

Select the environment's Python kernel and run the cells in order. For the optional chart, install Matplotlib in the same activated environment before starting JupyterLab:

```sh
python -m pip install matplotlib
```

On Windows, create the environment with `py -3 -m venv ..\universal-law-notebook-env` and activate it with `..\universal-law-notebook-env\Scripts\Activate.ps1` in PowerShell; the remaining `python` commands are the same. If you already have a notebook interface and Python kernel, use those directly.

These are notebook setup dependencies, not a dependency specification for the separate research branch or query package. The commands install compatible available package versions rather than a locked environment. Record your Python, JupyterLab and Matplotlib versions when sharing a replay. See the [JupyterLab installation guide](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html) and [Matplotlib installation guide](https://matplotlib.org/stable/install/index.html) for platform-specific setup.

## Source and scope

Input: [`Math-@9d7b6802424fb4715b31999066aafca8ee2f3cca:coefficients/side24_v1/ENCLOSURE.json`](https://github.com/d6g8k5htny-coder/Math-/blob/9d7b6802424fb4715b31999066aafca8ee2f3cca/coefficients/side24_v1/ENCLOSURE.json), 1090 bytes, SHA256 `72b6cd92d31394cdaf5da8919a5d548e902228af1f095cc184158a71d8287811`.

See the [scoped coefficient review](https://github.com/d6g8k5htny-coder/main/issues/65#issuecomment-5841269490) and [current program status](https://github.com/d6g8k5htny-coder/main/blob/main/STATUS.md) separately. Viewing or replaying these numbers does not accept a parent theorem. The public inventory remains [`../public-math/`](../public-math/sources.json); these files create no separate catalog.
Loading