Home /Modules/churn/README.md

README.md

churn/4/README.md · 136 line(s) · markdown

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">

<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">

/4 — Areas (Real Model Area)

Areas is the fourth relevance set (a sibling of /1 Longs, /2 Structures, /3 Facets, and /5 Lines). It is the Real Model Area: data modelled around area — a magnitude that spans, a real two-dimensional extent a model occupies.

The churn relevance sets read a magnitude five ways:

SetA magnitude that…We ask…
/1 Longsruns over timehow two lengths co-occupy
/2 Structuresstandsits magnitude and kind
/3 Facetsshows one facewhich face, of which object
/4 Areasspanshow much ground it covers, and its kind
/5 Linesreaches (1D)its count/length, and the Spark it teaches

This folder is the data + models for one relevance set. It gathers real, sourced areas across three domains, holds them as JSON / XML / TXT, rests them on a basis document — the Medium requirement for Workers, Work and Excellence — Workers — and carries a constraint layer encoding the repository's Constitution of congrains.

Kinds of Area. | Kind | Meaning | Example | |---|---|---| | EXACT | defined by an area formula — no uncertainty | circle area πr² | | MEASURED | a measured extent with an uncertainty | Earth's total surface 4πR² | | OBSERVED | a surveyed / published extent | Russia's total area; Lake Superior surface |

EXACT ≠ MEASURED ≠ OBSERVED; ASSOCIATION ≠ CAUSATION; ASSUMPTION ≠ FACT.

The three models

ModelDomainAreas it holds
models/PHYSICS_MODEL.mdphysics / geographycountry, continent, Earth-surface, and lake extents
models/MATH_MODEL.mdmathematicsplanar & surface area formulas
models/SOCIAL_MODEL.mdsocietyUS land area & population density

The data models

All data are real and sourced (each file embeds its provenance), stored as JSON, XML, or TXT so they read cleanly on GitHub or a public server:

FileFormatWhat it isSource
data/country-areas.jsonJSONlargest countries by total areaUN Statistics Division / CIA
data/earth-surface.xmlXMLEarth surface + land/water splitgeophysics / Wikipedia
data/geometry-areas.jsonJSONplanar & surface area formulaspublic-domain geometry
data/social-density-us.jsonJSONUS land area & densityUS Census / UN / CIA
data/continents.txtTXTthe seven continents by areastandard geographic figures
data/great-lakes.jsonJSONGreat Lakes by surface areaUS EPA / Britannica

The model

areas.sleela (syntax 1.2) loads Areas from all three domains as Area records and prints:

  1. a mathematical listing — each area's extent, order of magnitude, and kind;
  2. shares — geographic extents as a share of Earth's land; and
  3. an evaluation — what each area's kind (EXACT / MEASURED / OBSERVED) means for how far it can be trusted.
export SLEELA_SHA256_MANIFEST=security/sha256-manifest.json
export SLEELA_SHEET=SHEET.sheet
impl/build/sleela run churn/4/areas.sleela

The constraint layer (constraints & theory)

Every churn set is built around the repository's Constitution of congrains (see ../../README.md, "The Constitution"): the governing constraints and limits the system honors. /4 carries that theory in two forms:

The sibling sets /1–/3 carry the same layer, so all four share one constraint theory over their different magnitudes (Longs, Structures, Facets, Areas).

Running it — the dated Markdown report

Constraints.java prints its report to stdout and writes a well-formed Markdown document into a local DD-MM-YYYY/ folder (named for the run date), as churn-4-areas.md:

# from churn/4/
javac -d out Constraints.java
java -cp out com.mearvk.sleela.churn.Constraints
# => writes ./15-09-2026/churn-4-areas.md (the run date)

The report has an H1 title, a generation stamp, and sections for the system invariants, the Bound checks, capacity, and the connect-rule invariant — each as a Markdown table. The DD-MM-YYYY/ output folder is generated and is git-ignored (see ../.gitignore); it is a build artifact, not source. Sets /1–/3 write the same report to the same dated folder under their own names (churn-1-longs.md, churn-2-structures.md, churn-3-facets.md).

The basis

BASIS.md is the basis document this set rests on: the Medium requirement for Workers, Work and Excellence — Workers, read through the ground the working substrate spans — enough land, filled firmly enough to be assailable and firm.

Files

FileWhat it is
BASIS.mdthe Medium requirement for Workers, Work and Excellence — Workers
areas.sleelathe Areas model over all three domains
constraints.sleela / Constraints.javathe Constitution congrains/limits applied to Areas
models/the physics, math, and social model docs
data/the sourced data models (JSON / XML / TXT)

The areas here are real and sourced. EXACT areas are formula definitions, MEASURED areas carry uncertainty, and OBSERVED areas are surveyed/published extents. Any relation drawn between areas is a model, not a causal claim.