Guidelines

GRG Documentation Guidelines

Describe the construction through its geometric definitions. Use plain language, explicit hypotheses, and reproducible evidence.

Current Formulas

Use geometric lengths and ratios. Keep circular constants outside the construction’s formulas and numerical kernel. Explicit computational comparisons may use reference constants, with their role clearly stated.

Claims and Evidence

Distinguish definitions, proved statements, numerical observations, proposals, and applications. Do not claim efficiency, numerical stability, exact hardware arithmetic, or originality without supporting evidence.

Versioning

Identify historical formulations and retain their provenance. The binary radial formulation is the current two-dimensional reference.

Presentation

Keep site content in English. Provide accessible diagram descriptions, readable mathematical displays, and verified links. Avoid polemical slogans and comparisons that imply an unmeasured advantage.

Interoperability

Interoperability

Interoperability & Export

Category: Generative Radial Geometry (GRG)

GRG exports reproducible geometry and metadata for CAD/BIM, DCC, and scripting pipelines. Angles use turns with dyadic step Δu=2^{-n} (full turn); a quarter has M=2^{\,n-2} samples.

$$ n\in\mathbb{N}_{\ge 0},\qquad \Delta u=2^{-n}\ \text{(full turn)},\qquad M=2^{\,n-2}\ \text{(samples per quarter)}. $$

GRG Export Pack (recommended)

  • config.json — seed, n, rule, adaptive thresholds, weights, commit, timestamps.
  • nodes_quarter.obj — quarter polyline (units: meters; Z=0).
  • nodes_full.obj — reconstructed full polyline via ×4 symmetry.
  • strips.csv — per-step area strips (Δu, chord, sagitta).
  • metrics.json — P(n), A(n), ρ(Δu) stats, runtime, memory.
  • LICENSE — permissive license (MIT/Apache-2.0).
  • README.md — how to import into common tools.

Formats & Usage

Recommended export formats with contents and usage notes
FormatContentNotes
.OBJPolylinesLightweight; ideal for downstream thickening or meshing
.SVG2D vectorsGreat for print/CNC; preserves quarters and layers
.glTFRuntime-friendlyEmbed as lines/triangles for engines and viewers
.STEPCAD solids/surfacesProduce via downstream thickening/loft from polylines
.CSV/.JSONMetrics & paramsReproducibility and scripts; easy diffs

Units & Coordinate Frame

  • Units: meters by default; set units in config.json.
  • Frame: origin at seed; X to the right, Y up; quarter in first quadrant by convention, Z=0.
  • Winding: counter-clockwise sampling by increasing u.

Naming Conventions

  • grg_{project}_{yyyy-mm-dd}_{commit}/ root folder.
  • quarter_M{M}_n{n}.obj and full_M{M}_n{n}.obj for geometry.
  • metrics_P_A_{n}.json, strips_{n}.csv for analytics.

Export Pseudocode

GRG_Export(seed, n, rule, weights, adaptive):
  Δu ← 2^{-n}; M ← 2^{n-2}
  nodes_q ← BuildQuarter(seed, Δu, rule, weights, adaptive)
  nodes_f ← Reflect4(nodes_q)
  P, A  ← Aggregate(nodes_q)  # chords & strips
  write_obj("nodes_quarter.obj", nodes_q)
  write_obj("nodes_full.obj", nodes_f)
  write_csv("strips.csv", per_step_values)
  write_json("metrics.json", {P, A, rho_stats, runtime, mem})
  write_json("config.json", {seed, n, rule, weights, adaptive, units:"m"})

Round-tripping

  • To CAD: loft/thicken polylines; convert to NURBS; export STEP.
  • To DCC/Engines: glTF with line primitives or triangulated ribbons.
  • Back to GRG: keep config.json as the single source of truth.

Checks Before Shipping

  • Verify P(n), A(n) stabilization across dyadic refinements.
  • Ensure units and frame documented; include LICENSE.
  • Attach README with minimal import steps for target tools.