This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Shared Environment

Utility that connects two independent machines in a single mechanical environment


First Generation/Bodies



This content is specific to Simscape™ Multibody™ First Generation software. First-generation features are slated to be deprecated and should be avoided.

The Shared Environment block provides a nonphysical connection between two independent mechanical block diagrams, or submachines. The block carries no inertia, adds no joints, imposes no constraints, and transfers no motion, force, or torque between the Simscape Multibody blocks to which it is connected.

You can use this block to connect two independent machines into one machine, so that the two submachines then share the same machine environment. Making this connection does not change the structure or dynamics of either submachine.


The two connected submachines have to be independently valid, and each submachine requires at least one Ground block.

The resulting composite machine needs exactly one Machine Environment block, not two.

Dialog Box and Parameters

This block has no parameters.

Using the Shared Environment Block

The Shared Environment block features two general-purpose Simscape Multibody connector ports . To connect two machines to each other so that they share the same machine environment, connect each of these ports to either:

  • Another general-purpose connector port

  • A Body coordinate system (CS) port

This block diagram illustrates a valid composite machine formed by connecting two separate machines with a Shared Environment block. The composite machine requires and contains one and only one Machine Environment block.

Introduced before R2006a

Was this topic helpful?