Components are physical parts of your product that are represented with hierarchical relationships in a component tree. The top component is usually your product, for example a car, the car is then broken down into subcomponents, for example chassis, seats, wheels, etc.
Valis are added to components to describe the properites of that part.
Create a component¶
To create a component, right click on a project or another component and select "Create" in the dropdown. The component will be added as a subcomponent to the object that you clicked on. Name the component and click Enter to save. Another way to create a component is to click in "+ Component" button above the tree.
Components can be named with letters, numbers and underscore, no spaces or special characters are allowed. The component names have to be unique on the same level in the tree, but they can have the same name on different levels. The unique name of a component is the shortest possible unique name prepending the name of the parent in the tree.
This feature remembers which components belong together and keeps track of their consistency for you.
Right-click on any Component to create a copy of it. All changes which you make to this component (Values, sub components, etc.) will have an effect on all of its newly created copies, as long as they are connected.
You can see which component are connected at the top of a component page:
Valis of connected component are automatically connected.
Disconnecting Components and Valis¶
You can at any time disconnect a Vali or an entire component, by clicking on the link symbol connection symbol beside its name. Disconnecting specific Valis lets you trace components which are almost the same. All other Valis inof the same component will still be connected.
If you decide to reconnect a Vali which you have previous disconnected, you can do that by clicking on the
re-connection button reconnect button, which appears next to the
subscription button for disconnected Valis.
Connected Copy Logic¶
The following chapter is meant as a look-up, if you would like to know how Valispace behaves in edge-cases, before you apply the change.
A short in-depth overview of the connected-copy behaviour for advanced users
- If you create a copy of a component, the two components and all of their valis are connected.
- If the component has child-components, these are also copied and connected
- If you disconnect a component, all of its Valis are also disconnected.
- If the value of a Vali is changed to a number, all connected Valis will be updated with the same value
- Self-references (a Vali referencing another Vali of its own connected component) are maintained for connected Valis (they will also reference another Vali of their own component).
- If a Vali is disconnected, no change is applied to its value.
- If you had three Valis which were connected and you disconnect one, the other Valis still are connected.
- If you reconnect a Vali to a Group of connected Valis, it will receive the value of the other (already connected) Valis
- If you reconnect a Vali for which no Group of currently connected Valis exist, all previously disconnected Valis are re-connected and receive the value of the Vali you just re-connected.
In the beginning of a project, you may have different alternatives of components to use in your product, e.g. you can use a LiIon battery or a NiCd battery. They have the same parameters but with different values which affect the system.
Alternatives in Valispace are components that have the same parameters where one component is chosen as the selected alternative in the calculations.
Create and select an alternative¶
To create a new alternative, go to the component that you want to create an alternative for and click the button "Create alternative". Creating different alternatives for a battery will look like this in the component tree:
In the detailed view of
Battery, all the alternatives are shown with their corresponding Valis for comparison.
The currently selected alternative is marked in the table. To select one of the alternatives, click the radio button next to the name of that alternative. To de-select the alternative click the radio button of the currently selected. If no alternative is selected, the values of the Valis are all "0".
In the above example, all formulas using the battery properties should refer to
$Battery and not directly to the alternatives below.