classGettingStarted
Getting started
Extends from Icons.Information (Icon for general information packages (from MSL 3.2.1)).
Information
There are some points to note besides those in the "Usage" section of the top-level documentation:
- Turn off unit checking in Dymola:
Advanced.CheckUnits = false;This is automatic if QCalc is loaded via load.mos. - Call QCalc.Units.setup() to establish the display units in Dymola. This is automatic if QCalc is loaded via load.mos.
- Note that angle is explicit in the definitions of quantities,
units, and constants. This helps to identify dimensional inconsistencies
and provide insight into the physical equations.
Sometimes it is necessary to include factors
of
U.rad,U.cyc, etc. (whereUis QCalc.Units), but usually those units cancel. See QCalc.Units for details on where this is important. - The global variable
timeis in seconds. It is not a quantity, so it must be multiplied by the unit second (U.s) when used with other quantities. When writing a derivative, it is important to divide the result of thederoperator by the unit second:der(x)/U.s. By default, the second has a value of one, but this will not be the case if the base constants are changed. - When using results based on QCalc in an external tool, note that the values of the SI base and coherently derived units are not necessarily one. The values can be loaded from the "units.mos" file that is automatically generated by load.mos in the working directory.
- If you wish to introduce new quantities, it may help to use the quantities.xlsx spreadsheet.
- There are more details about the implementation in QCalc.Units.