OpenSite/Reference/Features/Quantities and expressions: Difference between revisions
BathAfrica (talk | contribs) Use BathAfrica sidebar contents without duplicate inline contents box |
BathAfrica (talk | contribs) Link adjacent OpenSite reference pages in reading order |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{OpenSite scope}} | |||
{{BathAfrica Feature | {{BathAfrica Feature | ||
|id=document.quantities | |id=document.quantities | ||
|summary=Store a physical value in canonical SI with a dimension and a quantity kind. | |summary=Store a physical value in canonical SI with a dimension and a quantity kind. | ||
| Line 14: | Line 14: | ||
}} | }} | ||
== Try this workflow == | |||
[[OpenSite/Guides/Quantities and profiles|Quantities and profiles]] — a worked lesson with expected results. | |||
== Documentation basis == | == Documentation basis == | ||
| Line 25: | Line 28: | ||
[[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]] | [[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]] | ||
[[Category:OpenSite documentation]] | [[Category:OpenSite documentation]] | ||
<div class="os-page-nav">{{Docnav|OpenSite/Reference/Features/Python scripting|OpenSite/Reference/Features/Rectangular section example|OpenSite/Guides|All guides}}</div> | |||
Latest revision as of 14:15, 29 October 2026
Store a physical value in canonical SI with a dimension and a quantity kind.
- Stable identifier
document.quantities
Status reported by source
Implemented in the reviewed development source. Historical test evidence is recorded by the repository; no test rerun or product release is claimed by this publication.
Units
Metre, kilogram, second, ampere, kelvin, mole, candela, and radian. Angle is an exponent. Absolute temperature is a kind. Celsius and Fahrenheit use documented offsets.
Behavior
Callers parse one number and one unit expression, convert with a registered unit, and format through a profile without changing the stored value. The rectangular section consumes these quantities.
Errors
incompatible_dimension, non_finite_value, unknown_unit, ambiguous_unit, unit_conflict, exponent_overflow, and parse_error.
Limitations
The quantity parser accepts numbers and unit expressions; property expressions are a separate document feature. Restricted formulas and opt-in Python property expressions exist in this snapshot. Python source is retained without automatic execution on load; evaluation requires consent and the shared runtime. Negative kelvin may be accepted by the quantity layer and is not an engineering-domain validation. Unit profiles are not design-code checks.
Available hosts
GUI-independent C++ foundation, CLI and embedded Python, consumed by desktop quantity editors and the property inspector on the Windows development configuration.
Licensing and access
The units engine is OpenSite code. It does not check an entitlement. Presentation changes do not change the stored SI value.
Verification evidence
Repository evidence references (not rerun for this publication): CTest foundation.quantity and foundation.units. ADR-0008.
Try this workflow
Quantities and profiles — a worked lesson with expected results.
Documentation basis
Source-reviewed against development commit 77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7, branch feature/phase-13c-properties-python-expressions. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.
src/foundation/quantity_parser.cppsrc/document/expression.cppsrc/python/bindings.cppdocs/verification/Phase-13C-Integration.md
