Simscape Block Libraries

Library Structure Overview

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

  • Foundation library — Contains basic hydraulic, mechanical, electrical, magnetic, thermal, thermal liquid, two-phase fluid, gas, moist air, 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, you will see the corresponding libraries under the main Simscape library. Add-on products are products in the Physical Modeling family that use Simscape platform and, as a result, share common functionality such as physical units management, editing modes, and so on.

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

  • Thermal building blocks that model fundamental thermal effects

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

  • Two-phase fluid building blocks that model fundamental thermodynamic effects in systems where the working agent is part liquid and part vapor

  • Gas building blocks that let you model gas systems with various levels of idealization: perfect gas, semiperfect gas, or real gas

  • Moist air building blocks that let you model two- and three-species gas systems, keeping track of humidity and trace gas levels in the air mixture

  • 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.

Accessing the Block Libraries

You can access the blocks through the Simulink Library Browser. To display the Library Browser, type slLibraryBrowser in the MATLAB® Command Window. Then expand the Simscape entry in the contents tree.

When you type simscape in the MATLAB Command Window, the main Simscape library opens in a separate 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.