Adams Controls Plant Export
Controls → Plant Export
Exports the Adams plant files. Adams Controls saves the input and output information in an .m (for MATLAB) or .inf file (for EASY5). It also generates a command file (.cmd) and a dataset file (.adm) that are used during the simulation process. Adams could also export the model as a .fmu file (Functional Mock-up Unit or FMU) that follows the FMI standard.
For the option: | Do the following: |
|---|---|
Controls Plant selection | Specify whether you are creating a new controls plant or modifying an existing one. Enter the name of the new or existing plant in the text box to the right. |
File Prefix | Enter the prefix for the .adm, .cmd, .acf, .m, and .inf files that Adams Controls creates. |
Initial Static Analysis | Select one of the following: ■Yes: Performs initial static analysis. ■No: Does not perform initial static analysis. Note: If Initial Static Analysis is set to Yes and Type is set to linear, Adams Controls performs a static analysis before the linear analysis. Otherwise, Adams Controls performs an initial conditions analysis. |
Initialization Command | Check if you want to enter Adams View or Adams Solver non-time advancing (NTA) commands that you want to have executed before the co-simulation or function evaluation starts. In the text box that appears, enter one NTA command. To execute more than one NTA command, create an .acf file and refer to it using the FILE/COMMAND = command_file_name string in this text box. |
Import Settings from Existing Controls Plant | Select to display the Database Navigator, where you can choose an existing controls plant whose settings you want to use in your current plant. Adams Controls updates the Adams Controls Plant Export dialog box with the appropriate settings. |
Input Signals | Enter names of state variables that you want to use as plant inputs. Select From Pinput to enter state variables from existing plant inputs. |
Output Signals | Enter names of state variables that you want to use as plant outputs. Select From Poutput to enter state variables from existing plant outputs. |
Re-order Adams Inputs Signal(s)/Re-order Adams Output Signal(s) | The reorder of plant inputs and outputs change the order of the signals in the PINPUT and POUTPUT entities. This is useful when you already created the PINPUT and POUTPUT entities and at a later point in time (during plant export) would like to reorder the signals within them. Note: The order of signals should be same during plant export and plant import. Otherwise, simulation could fail and produce undesired results. |
Target Software | Select one of the following: ■Easy5 ■MATLAB ■FMU - Creates a Functional Mock-up Unit that follows the FMI standard. |
Analysis Type | Select one of the following: ■linear - Creates a linearized representation of the model in terms of (A, B, C, D) matrices. A linear analysis is performed. For Target Software of FMU, this option is not supported. ■non_linear - Exports plant for dynamic analysis. |
Adams Solver Choice | Select one of the following: ■Fortran - Uses the default Adams Solver (FORTRAN) for this simulation. ■C++ - Uses Adams Solver (C++) for this simulation. |
User Defined Library Name | Enter the name of the user-defined library. |
Adams Host Name | Enter the name of the host machine from which the Adams plant is being exported. This host name is used if you choose TCP/IP-based communication to perform cosimulation or function evaluation between Adams and MATLAB, Easy5 or FMU. |
Communication Mode | This option is only available for FMU target software. The different possible modes of communication are PIPES/TCP-IP or DIRECT. PIPES mode of communication requires the Adams and the FMU parent to run on the same PC. TCP/IP allows you to run Adams on one workstation while running FMU parent on a second networked machine of the same or different architecture. DIRECT mode is applicable only with the C++ solver. This option only works when Adams is not the parent. If an Adams FMU is exported with this option and is imported into Adams for execution, then initialization of the FMU would fail. |
Dynamic State Output | Dynamic States Output performs an initial conditions analysis or a static analysis (if Initial Static Analysis is set to Yes), and computes the number of states (that is, displacements, velocities) in the model. This is used by Easy5 for Function Evaluation mode. If your model has difficulty computing this properly, you can disable this feature, but you will not be able to use Function Evaluation mode unless the number for NUMBER OF STATES is modified in the .inf file from Plant Export. |
Include MNF | This option is available only when the target software is selected as FMU v1 or v2. It provides the user an option to either include the mnf files or exclude them from the FMU. These are used for the animation of the flex bodies in the model. Excluding these files could reduce the size of the FMU considerably. It is enabled only when there are flex bodies in the model and when there are no flex body contacts. If there are no flex bodies in the model, then it is disabled and set to a value of "No" by default. If there are flex body contacts in the model, then it is disabled and set to a value of "Yes" by default. |
Output Rate | This option is available only when the target software is selected as FMU v1 or v2. It takes an integer value which specifies a multiplier of the communication interval between parent and child for writing the Adams results to file. |
 | This button is enabled when the Target Software is selected as FMU v1.0 or FMU v2.0. Clicking on this button opens up a dialog where model parameters can be selected for export. Currently, design variables, points and mass properties are supported in AView models. Parameter variables, hard points, mass properties, UDE design variables and property files are supported in ACar models. Note: dSPACE does not support modification of string parameters in the FMU. |
Real Time FMI Parent | This selection is visible only if the "Target Software" selection is either FMU v1.0 or FMU v2.0. When FMU v1.0 is selected, the options are None and SIMulation Workbench. When FMU v2.0 is selected, the options are None, SIMulation Workbench and SCALEXIO. Selection of "None" results in a generic FMU being generated that can be used in non-realtime environments. Options like "Adams Solver Choice" and "Communication Mode" are enabled and are available for selection. Selection of either "SIMulation Workbench" or "SCALEXIO" results in an FMU customized for the corresponding real-time FMI Parent. In this case, the options like "Adams Solver Choice" and "Communication Mode" are unavailable for selection. |
Add to FMU | Use this field to select the files that will be copied/bundled into the FMU. When an FMU ‘consumer’ application loads the Adams FMU, these additional files will be present in the same working directory (‘resources’ folder inside the FMU) as the Adams model files. |
Encrypt Model | This option is available only when the target software selected is FMU v1 or v2. It generates an encrypted FMU. Such an FMU contains an encrypted Adams Solver dataset file with extension .adme. It does not contain an Adams View command file (.cmd) representation of the model. If the Encrypt Model option is selected, the "Expose Parameters" button will be disabled because exposed parameters are not supported by the encrypted FMU. Solver will not allow a LIST argument on an object command in encrypted models. |
SmartConnect FMU | This option is available only when the target software selected is FMU v2. It stores model files in SmartConnect FMU. For more information please refer SmartConnect FMU. |