Simscape Block Libraries

Library Structure Overview

Simscape block library contains two libraries that belong to the Simscape™ product:

  • Foundation library — Contains basic hydraulic, pneumatic, mechanical, electrical, magnetic, thermal, thermal liquid, and physical signal blocks, organized into sublibraries according to technical discipline and function performed

  • Utilities library — Contains essential environment blocks for creating Physical Networks models

In addition, if you have installed any of the add-on products of the Physical Modeling family, you will see the corresponding libraries under the main Simscape library.

Simscape Foundation libraries contain a comprehensive set of basic elements and building blocks, such as:

  • Mechanical building blocks for representing one-dimensional translational and rotational motion

  • Electrical building blocks for representing electrical components and circuits

  • Magnetic building blocks that represent electromagnetic components

  • Hydraulic building blocks that model fundamental hydraulic effects and can be combined to create more complex hydraulic components

  • Pneumatic building blocks that model fundamental pneumatic effects based on the ideal gas law

  • Thermal building blocks that model fundamental thermal effects

  • Thermal liquid building blocks that model fundamental thermodynamic effects in liquids

  • Physical Signals block library that lets you perform math operations on physical signals, and graphically enter equations inside the physical network

Using the elements contained in these Foundation libraries, you can create more complex components that span different physical domains. You can then group this assembly of blocks into a subsystem and parameterize it to reuse and share these components.

In addition to Foundation libraries, there is also a Simscape Utilities library, which contains utility blocks, such as:

  • Solver Configuration block, which contains parameters relevant to numerical algorithms for Simscape simulations. Each Simscape diagram (or each topologically distinct physical network in a diagram) must contain a Solver Configuration block.

  • Simulink-PS Converter block and PS-Simulink Converter block, to connect Simscape and Simulink® blocks. Use the Simulink-PS Converter block to connect Simulink outports to Physical Signal inports. Use the PS-Simulink Converter block to connect Physical Signal outports to Simulink inports.

For examples of using these blocks in a Simscape model, see the tutorial Creating and Simulating a Simple Model.

You can combine all these blocks in your Simscape diagrams to model physical systems. You can also use the basic Simulink blocks in your diagrams, such as sources or scopes. See Connecting Simscape Diagrams to Simulink Sources and Scopes for more information on how to do this.

Simscape block libraries contain a comprehensive selection of blocks that represent engineering components such as valves, resistors, springs, and so on. These prebuilt blocks, however, may not be sufficient to address your particular engineering needs. When you need to extend the existing block libraries, use the Simscape language to define customized components, or even new physical domains, as textual files. Then convert your textual components into libraries of additional Simscape blocks that you can use in your model diagrams. For more information on how to do this, see Typical Simscape Language Tasks.

Using the Simulink Library Browser to Access the Block Libraries

You can access the blocks through the Simulink Library Browser. To display the Library Browser, click the Simulink Library button in the toolbar of the MATLAB® desktop. Alternatively, you can type simulink in the MATLAB Command Window. Then expand the Simscape entry in the contents tree.

Using the Command Prompt to Access the Block Libraries

To access individual block libraries by using the command prompt:

  • To open the Simscape library, type simscape in the MATLAB Command Window.

  • To open the main Simulink library (to access generic Simulink blocks), type simulink in the MATLAB Command Window.

The Simscape library consists of two top-level libraries, Foundation and Utilities. In addition, if you have installed any of the add-on products of the Physical Modeling family, you will see the corresponding libraries under Simscape library, as shown in the following illustration. Some of these libraries contain second-level and third-level sublibraries. You can expand each library by double-clicking its icon.

Was this topic helpful?