WOLFRAM

Wolfram Language & System Documentation Center

SMA (.sma)

Background & Context

    • System Modeler archive files that include model dependencies.
    • File format created by Wolfram Research, Inc.
    • Imported result data is represented as a SystemModel.

Import & Export

Import Elements

  • General Import elements:
  • "Elements" list of elements and options available in this file
    "Summary"summary of the file
    "Rules"list of rules for all available elements

Options

  • Import option:
  • "TrustExternalFunctions"Falsewhether to trust external functions in file
  • Export option:
  • "IncludedLibraries"Automaticlibraries to include in file
  • Possible values for "IncludedLibraries" are:
  • Automaticautomatically decide what to include
    Noneinclude no dependencies
    Allinclude all dependencies
    "User"include dependencies not shipped with the system
    {lib1,lib2,…}include the explicit libraries libi

Examples

open all close all

Basic Examples  (2)

Import a total model from an archive:

Wolfram Language code: model = Import["ExampleData/ExampleModelTotal.sma", "SMA"]

Examine the model's equations:

Wolfram Language code: model["SystemEquations"]

Simulate the model:

Wolfram Language code: sim = SystemModelSimulate[model, 1]
Wolfram Language code: SystemModelPlot[sim, {"x", "y", "y"'}]

Export a model with dependencies:

Wolfram Language code: file = Export["Newton.sma", [image], "SMA"]

Import the model again:

Wolfram Language code: model = Import[file, "SMA"]

Simulate for 10 seconds and plot the first stored plot in the model:

Wolfram Language code: SystemModelPlot[{model, 10}, First[model["PlotNames"]]]

Clean up by deleting the new file and model:

Wolfram Language code: DeleteFile[file]; DeleteObject[model];

Import Options  (1)

"TrustExternalFunctions"  (1)

Import with evaluation of external functions enabled:

Wolfram Language code: model = Import["ExampleData/WithExternal.sma", "TrustExternalFunctions" -> True]

This model contains external functions:

Wolfram Language code: First[model]["ModelicaString"]

Simulate the model and plot the simulation results:

Wolfram Language code: SystemModelPlot["MyPackage.MyModel", "z", 10]

Export Options  (1)

"IncludedLibraries"  (1)

Export a model without any dependencies:

Wolfram Language code: file = Export["NoDependencies.sma", [image], "SMA", "IncludedLibraries" -> None]

The resulting file size is typically small:

Wolfram Language code: FileSize[file]

Including all dependencies, including system libraries, typically results in a large file:

Wolfram Language code: fileAll = Export["AllDependencies.sma", [image], "SMA", "IncludedLibraries" -> All]
Wolfram Language code: FileSize[fileAll]
Wolfram Language code: DeleteFile[{file, fileAll}]