Template:Essentia/doc: Difference between revisions

Jump to navigation Jump to search
AdminIsidore (talk | contribs)
No edit summary
AdminIsidore (talk | contribs)
No edit summary
Line 1: Line 1:
{{Documentation}}
== Purpose ==
== Purpose ==
The '''Template:Essentia''' structures entries in the [[Essentia:]] namespace of OODA.wiki, part of the [[AetherOS]] architecture. It defines terms as semantic objects aligned with [[Philosophical Realism]], modeling universal essences (e.g., matter, life, truth) rather than Nominalist signals (e.g., job titles, data clusters). The template sets SMW properties for queryability, supports tooltips via Semantic Glossary, and renders a dynamic relationship graph.
The '''Template:Essentia''' structures entries in the [[Essentia:]] namespace of OODA.wiki, part of the [[AetherOS]] architecture. It defines terms as semantic objects aligned with [[Philosophical Realism]], modeling universal essences (e.g., matter, life, truth) rather than Nominalist signals (e.g., job titles, data clusters). The template sets Semantic MediaWiki (SMW) properties for queryability, supports tooltips via [[Extension:Semantic Glossary]], and renders a dynamic relationship graph.


== Usage ==
== Usage ==
Use via [[Form:Essentia]] or pywikibot. Create entries at <code>ooda.wiki/wiki/Essentia:<Term></code> (e.g., Essentia:Materia). Parameters map to SMW properties:
Use via [[Form:Essentia]] or pywikibot to create/edit entries at <code>ooda.wiki/wiki/Essentia:<Term></code> (e.g., Essentia:Materia). Parameters map to SMW properties:
 
* '''term''': [[Property:Essentia Term]] (Page; defaults to page name).
* '''term''': Sets [[Property:Essentia Term]] (Page; defaults to page name).
* '''primary_essentia''': [[Property:Is about essence]] (Page; one of 12 Essentia: Physica, Vita, Forma, Mens, Ars, Societas, Symbolum, Bonum, Tempus, Cosmos, Veritas, Identitas).
* '''primary_essentia''': Sets [[Property:Is about essence]] (Page; one of 12 Essentia).
* '''definition''': [[Property:Has definition]] (Text).
* '''definition''': Sets [[Property:Has definition]] (Text).
* '''essence_connection''': [[Property:Has essence connection]] (Text; links term to essence).
* '''essence_connection''': Sets [[Property:Has essence connection]] (Text; links term to essence).
* '''associations''': [[Property:Is associated with]] (Page; comma-separated Essentia: pages).
* '''associations''': Sets [[Property:Is associated with]] (Page; comma-separated Essentia: pages).
* '''data_chunks''': [[Property:Links to data chunk]] (Text; data source references).
* '''data_chunks''': Sets [[Property:Links to data chunk]] (Text; data source references).
* '''saga_tunings''': [[Property:Has SAGA tuning]] (Text; JSON-like SAGA parameters).
* '''saga_tunings''': Sets [[Property:Has SAGA tuning]] (Text; JSON-like SAGA parameters).
* '''confidence''': [[Property:Has confidence score]] (Number; 0.0–1.0).
* '''confidence''': Sets [[Property:Has confidence score]] (Number; 0.0–1.0).
* '''source''': [[Property:Has source]] (Text; citation).
* '''source''': Sets [[Property:Has source]] (Text; citation).


== Example ==
== Example ==
<pre>
To create an entry for "Materia":
{{Essentia
- Page: <code>Essentia:Materia</code>
|term=Materia
- Input (via Form:Essentia or pywikibot):
|primary_essentia=Physica
  - term: Materia
|definition=Fundamental substance of physical reality, encompassing mass and its properties.
  - primary_essentia: Physica
|essence_connection=Materia embodies Physica’s essence by representing the universal reality of matter, governed by physical laws.
  - definition: Fundamental substance of physical reality, encompassing mass and its properties.
|associations=Energia,Spatium,Causalitas
  - essence_connection: Materia embodies Physica’s essence by representing the universal reality of matter, governed by physical laws.
|data_chunks=physics_laws:123,material_db:456
  - associations: Energia,Spatium,Causalitas
|saga_tunings={"causal_modeling": {"weight": 0.8, "goal": "predict interactions"}, "material_optimization": {"weight": 0.7, "goal": "enhance efficiency"}}
  - data_chunks: physics_laws:123,material_db:456
|confidence=0.95
  - saga_tunings: {"causal_modeling": {"weight": 0.8, "goal": "predict interactions"}, "material_optimization": {"weight": 0.7, "goal": "enhance efficiency"}}
|source=arXiv:1234.5678
  - confidence: 0.95
}}
  - source: arXiv:1234.5678
</pre>


== SMW Integration ==
== SMW Integration ==
The template sets semantic properties for each parameter, enabling queries, tooltips (via [[Extension:Semantic Glossary]]), and graphs. A dynamic graph is rendered in the <code>essentia-graph</code> div using an SMW <code>#ask</code> query, with support for D3.js customization via the GlossaryGraph gadget. Properties must be defined:
The template sets SMW properties for queryability, tooltips, and graphs:
- [[Property:Essentia Term]] (Page)
- Properties (create on wiki):
- [[Property:Is about essence]] (Page)
  - [[Property:Essentia Term]] (Page)
- [[Property:Has definition]] (Text)
  - [[Property:Is about essence]] (Page)
- [[Property:Has essence connection]] (Text)
  - [[Property:Has definition]] (Text)
- [[Property:Is associated with]] (Page)
  - [[Property:Has essence connection]] (Text)
- [[Property:Links to data chunk]] (Text)
  - [[Property:Is associated with]] (Page)
- [[Property:Has SAGA tuning]] (Text)
  - [[Property:Links to data chunk]] (Text)
- [[Property:Has confidence score]] (Number)
  - [[Property:Has SAGA tuning]] (Text)
- [[Property:Has source]] (Text)
  - [[Property:Has confidence score]] (Number)
  - [[Property:Has source]] (Text)
- A dynamic graph in the <code>essentia-graph</code> div uses an SMW <code>#ask</code> query to visualize bidirectional associations (<code>[[Is associated with]]</code>), with support for D3.js via the GlossaryGraph gadget.
- Tooltips are enabled via Semantic Glossary for terms and definitions.


== Rendering ==
== Rendering ==
The template uses an Infobox for structured display, with sections for Overview, Essence Connection, and Semantic Relationship Graph. The graph visualizes bidirectional associations (<code>[[Is associated with]]</code>) with a green CRT aesthetic.
The template renders:
- An Infobox with structured data (Primary Essentia, Definition, etc.).
- Sections for Overview, Essence Connection, and Semantic Relationship Graph.
- Categories: <code>[[Category:Essentia]]</code> and <code>[[Category:Essentia - <Primary Essentia>]]</code>.


== AI Compatibility ==
== AI Compatibility ==
Salii AI models can create/edit entries via pywikibot, submitting structured data to populate SMW properties. The <code>saga_tunings</code> field supports JSON-like input for AetherOS integration.
Salii AI models can use pywikibot to create/edit entries, submitting structured data to populate SMW properties. The <code>saga_tunings</code> field supports JSON-like input for AetherOS integration.
 
== Notes ==
- To avoid template loops, this documentation does not transclude Template:Essentia.
- Ensure SMW properties are defined before use.
- The <code>essentia-graph</code> div requires a GlossaryGraph gadget for D3.js enhancements.


== See Also ==
== See Also ==
Line 54: Line 64:
* [[Form:Essentia]]
* [[Form:Essentia]]
* [[SAGA (Self-Adapting Goal Architecture)]]
* [[SAGA (Self-Adapting Goal Architecture)]]
[[Category:Template Documentation]]