Documentation

vrphysmod

Add virtual reality visualization framework to block diagrams

Syntax

vrphysmod(virtualWorldFile,system)

Description

vrphysmod(virtualWorldFile,system)updates the Simulink®system (model or subsystem) that theSimscape™ Multibody™mech_importfunction generates.

The model must be on the MATLAB®path or already open prior to calling thevrphysmodfunction.

The.wrlextension is optional for a VRML virtual world file. If the specified system was created withSimscape MultibodyFirst Generationmech_importfunction, you can specify also an.x3dor.x3dvfile for thevirtualWorldFile.

As necessary,vrphysmodadds additional blocks to visualize the mechanical system in virtual reality. The association between mechanical system bodies and corresponding nodes found in the virtual world 3D file is based on the name correspondence.

If your model contains severalVR Sinkblocks that refer to the samevirtualWorldFile, this function attempts to consolidate the animation signals of that virtual scene into one VR Sink block.

You can then save, rename, modify, and run the model. When you save the resulting model, be sure to preserve the relative path between the Simulink system and the virtual world 3D file.

Note

The SolidWorks®VRML export filter does not preserve part instance names and the part order in the resulting virtual world 3D file. Therefore, the association between such parts and the corresponding bodies in the block diagram is not always an exact match. In such cases, the function identifies nodes with partial matches and issues warnings. To prevent these warnings, ensure that nodeDEFnames in the virtual world 3D file are identical to their corresponding bodies in the Simulink model before running this function.

If you receive this warning and the set of virtual world 3D files does not originate in the SolidWorks product, ignore the message. Other supported CAD tools also generate part names with similar names, but preserve them across different export formats.

Examples

To update the modelfour_linkusing the filefour_link.wrl:

vrphysmod('four_link.wrl', 'four_link');

To update the subsystemfour_link/FOURLINK_ASMusing the VRML filefour_link.wrl, ensure that the model that contains the subsystem is open, then:

vrphysmod('four_link.wrl', 'four_link/FOURLINK_ASM');

To update the current system using the filefour_link.wrl:

vrphysmod('four_link.wrl', gcs);

Introduced in R2009a