areas.sleela
churn/4/areas.sleela · 126 line(s) · sleela
#sleela 2.1
// 4/areas.sleela -- "Areas": the general model for relevance set /4.
//
// The progression of the churn relevance sets:
// /1 Longs -- magnitudes that RUN OVER TIME (length series)
// /2 Structures -- magnitudes that STAND (a standing quantity)
// /3 Facets -- one FACE of a many-sided object
// /4 Areas -- magnitudes that SPAN (a real 2D extent a model occupies)
//
// An Area is a named region with a two-dimensional extent (square units). The
// model loads Areas from three domains -- geographic (physics/earth), planar
// (math), and social (a society's land + density) -- and reports each Area's
// extent, its order of magnitude, its share of a reference extent, and its kind.
//
// Data are real and sourced (see data/*.json|xml|txt and README.md):
// physics : country / earth-surface / continent / lake extents (UN/EPA/etc.)
// math : planar & surface area formulas (public domain geometry)
// social : US land area and population density (Census / UN)
//
// Discipline: EXACT areas are defined by formula; MEASURED/OBSERVED areas are
// published extents. A relation drawn between areas is a MODEL, not a causal
// claim. ASSOCIATION != CAUSATION; ASSUMPTION != FACT.
import math;
struct Area {
String domain; // "physics" | "math" | "social"
String name;
double extent; // the 2D extent (square units)
String unit;
String kind; // "EXACT" (defined) | "MEASURED" | "OBSERVED"
}
class Areas {
// Order of magnitude = floor(log10(|extent|)); 0 for a zero/undefined area.
double orderOfMagnitude(double v) {
double a = math.abs(v);
if (a <= 0.0) { return 0.0; }
return math.floor(math.log10(a));
}
// Share of a reference extent, as a percent (clamped to >= 0).
double sharePercent(double extent, double reference) {
if (reference <= 0.0) { return 0.0; }
double s = (extent / reference) * 100.0;
if (s < 0.0) { return 0.0; }
return s;
}
// One report line for an Area: extent, order of magnitude, and kind.
void report(Area a) {
double om = orderOfMagnitude(a.extent);
print(" [" + a.domain + "] " + a.name + " = " + a.extent
+ " " + a.unit + " (10^" + om + ", " + a.kind + ")");
}
void reading(Area a) {
print(" " + a.name + " (" + a.domain + ") is " + a.kind
+ ": " + trust(a.kind) + ".");
}
String trust(String kind) {
if (kind == "EXACT") { return "defined by an area formula -- no uncertainty"; }
if (kind == "MEASURED") { return "a measured extent -- carries an uncertainty"; }
return "an observed published extent -- as surveyed";
}
void main() {
double worldLand = 148940000.0; // km^2, reference world landmass
// --- geographic Areas (physics/earth; data/country-areas.json etc.) ---
Area russia = new Area();
russia.domain = "physics"; russia.name = "Russia (total area)";
russia.extent = 17098242.0; russia.unit = "km^2"; russia.kind = "OBSERVED";
Area usa = new Area();
usa.domain = "physics"; usa.name = "United States (total area)";
usa.extent = 9833517.0; usa.unit = "km^2"; usa.kind = "OBSERVED";
Area earthLand = new Area();
earthLand.domain = "physics"; earthLand.name = "Earth land surface";
earthLand.extent = 148940000.0; earthLand.unit = "km^2"; earthLand.kind = "OBSERVED";
Area superior = new Area();
superior.domain = "physics"; superior.name = "Lake Superior (surface)";
superior.extent = 82100.0; superior.unit = "km^2"; superior.kind = "OBSERVED";
// --- planar Areas (math; data/geometry-areas.json) ---
Area circle = new Area();
circle.domain = "math"; circle.name = "circle area (r=2)";
circle.extent = 12.566370614; circle.unit = "unit^2"; circle.kind = "EXACT";
Area hexagon = new Area();
hexagon.domain = "math"; hexagon.name = "regular hexagon area (s=2)";
hexagon.extent = 10.392304845; hexagon.unit = "unit^2"; hexagon.kind = "EXACT";
// --- social Areas (society; data/social-density-us.json) ---
Area usLand = new Area();
usLand.domain = "social"; usLand.name = "US land area";
usLand.extent = 9147420.0; usLand.unit = "km^2"; usLand.kind = "OBSERVED";
print("=== /4 Areas -- real 2D extents that a model spans, per domain ===");
print("Kinds: EXACT (defined by formula), MEASURED, OBSERVED (surveyed).");
print("");
print("[mathematical] area extents and orders of magnitude");
report(russia); report(usa); report(earthLand); report(superior);
report(circle); report(hexagon);
report(usLand);
print("");
print("[shares] geographic extent as a share of Earth's land (" + worldLand + " km^2)");
print(" Russia: " + sharePercent(russia.extent, worldLand) + " %");
print(" United States: " + sharePercent(usa.extent, worldLand) + " %");
print(" US land only: " + sharePercent(usLand.extent, worldLand) + " %");
print("");
print("[evaluation] what each area's kind means for trust");
reading(circle); reading(russia); reading(usLand);
print("");
print("Note: real sourced data (UN/CIA/EPA geography, public-domain");
print("geometry, US Census). An Area spans a region; a relation between");
print("areas is a MODEL, not a causal claim.");
}
}