Cairn Documentation
Nodes & Properties
Nodes are the building blocks of every model. Each node represents a piece of your system at some level of abstraction.
What a Node Contains
- Name: A short identifier ("Power Subsystem", "Battery Pack")
- Type: system, subsystem, assembly, part, or external
- Description: Plain-language explanation of what this node is and does
- Parent: Which node contains this one (except the root)
- Properties: Engineering parameters like mass, power, cost
The Properties Catalog
Properties are key-value pairs with engineering semantics:
- Key: Identifier (e.g., "mass", "power_nominal")
- Value: Numeric or text value
- Unit: From the project's unit catalog (kg, W, mm, etc.)
- Category: Grouping (physical, electrical, thermal, etc.)
- Source: Where this value came from (estimate, datasheet, test, derived)
| Property | Unit | Category | Typical Use |
|---|---|---|---|
| mass | kg | physical | Weight budgets |
| power_nominal | W | electrical | Power budgets |
| power_peak | W | electrical | Worst-case analysis |
| cost | USD | economic | Cost rollups |
| mtbf | hours | reliability | Reliability analysis |
| operating_temp_min | °C | thermal | Environmental limits |
| operating_temp_max | °C | thermal | Environmental limits |
Budget Rollups
Some properties roll up automatically from children to parents. A subsystem's mass is the sum of its parts' masses. The Overview lens shows budget bars comparing allocated vs. actual values.
AI Property Suggestions
The Properties panel includes an AI suggestion button that proposes domain-appropriate properties based on the node's name, type, and description. Accept individually or all at once.