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. Watch this tutorial video to learn more:
Creating a Component¶
To create a component, either click on the "+ Add component" button under the project tree or right-click a component and select "+ Add component" in the dropdown menu. The component will be added as a subcomponent to the object that you clicked on. Name the component and click
Components can be named with letters, numbers and underscores, 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.
To copy a component and all its valis, right click the component and select the "Copy" button.
This feature remembers which components belong together and keeps track of their consistency for you.
To create a connected copy, click the "Copy & Connect" button. 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 components are connected in the project tree. Connected components have a symbol in front of them.
Disconnecting Components and Valis¶
You can at any time disconnect a Vali or an entire component. For a component this is done by right-clicking it and subsequently clicking the "Disconnect button". For a Vali it is done by clicking the connected symbol on the right side of the screen. Disconnecting specific Valis lets you trace components which are almost the same. All other Valis of the same component will still be connected.
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.
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". This will create a new component under the original component as an alternative. To add more alternatives, go to the original component and click the + symbol in the bottom right. You can choose to add an existing component, duplicate an existing component or create a whole new component as alternative. Once you have created all the desired alternatives, you can select what Valis you want to show up in the component. Do this by again clicking the + symbol and selecting Create Vali. You can now type the Vali you want to appear and what unit it should have. 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 "select alternative" button under the name of that alternative. 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.
In the component tree, the alternatives will show up as follows: