Home /Modules/impl/README.md

README.md

impl/subjects/README.md · 66 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">

SLeeLa Subject Libraries

This directory unifies the five SLeeLa subject libraries — Math, Physics, Economics, Chemistry, and Financial — under a single, predictable layout. Each subject has its own folder. Everything a subject owns (its library implementation, its frontend lowering, and its data/model files) lives together in that folder.

subjects/
├── native/       Shared native dispatcher + AST builders for the arithmetic subjects
│   ├── native_api.{h,cpp}   validate imports, enforce the math dependency,
│   │                        dispatch to the per-subject builders, and lower
│   │                        qualified calls (e.g. math.sqrt) into native methods
│   ├── native_builders.h    shared inline AST-builder helpers (V, D, Bn, C0..C2,
│   │                        Neg, Ret, Decl, Set, Loop, M0..M4)
│   └── native_add.h         declarations of addMath / addPhysics / addEconomics
├── math/         math_native.cpp        → addMath        (__NativeMath)
├── physics/      physics_native.cpp     → addPhysics     (__NativePhysics)
├── economics/    economics_native.cpp   → addEconomics   (__NativeEconomics)
├── chemistry/    chemistry.{h,cpp}, chemistry_api.{h,cpp}, *.model
├── finance/      financial.{h,cpp}, financial_api.{h,cpp}, FINANCIAL.model, README.md
└── conversion/   conversion.model, README.md  (Java -> SLeeLa laws; consumed by sleelactl/convert)

Two shapes of subject library

The subjects come in two shapes, and the layout makes both explicit:

  1. Arithmetic subjects (math, physics, economics) — these synthesize ordinary Sleela Core methods from a shared set of AST-builder primitives. Because they share those builders and a single dispatcher, the common code lives in native/ while each subject's own class builder lives in its own single file (math/, physics/, economics/). This gives one file per subject and one unified place for the shared machinery.
    • Math is the foundational numeric domain.
    • Physics and Economics depend on Math; native_api.cpp enforces that import physics / import economics requires import math.
  1. Standalone compiled subjects (chemistry, finance) — these are independent compiled C++ libraries (chemistry.cpp, financial.cpp) each paired with a frontend adapter (chemistry_api.cpp, financial_api.cpp) and their declarative model files. They are lowered separately from the native dispatcher so inferred/modeled results stay distinguishable from measured or specified values.

Build

The subject sources are compiled by the top-level impl/Makefile. Each subject include directory is on the compiler search path, so subject headers are included by bare name (e.g. #include "native_api.h"). Per-subject build checks are available:

make test-math test-physics test-economics test-chemistry test-financial