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 the Simscape™
Multibody™
smimport
(Simscape Multibody) function generates.
The model must be on the MATLAB® path or already open prior to calling the vrphysmod
function.
The .wrl
extension is optional for a VRML virtual world file. If the
specified system was created with Simscape
Multibody First Generation smimport
(Simscape Multibody) function, you can specify also an
.x3d
or .x3dv
file for the
virtualWorldFile
.
As necessary, vrphysmod
adds 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 several VR Sink blocks that refer to the same
virtualWorldFile
, 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 node DEF
names 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 model four_link
using the file
four_link.wrl
:
vrphysmod('four_link.wrl', 'four_link');
To update the subsystem four_link/FOURLINK_ASM
using the VRML file
four_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 file four_link.wrl
:
vrphysmod('four_link.wrl', gcs);
Version History
See Also
stl2vrml
| vrcadcleanup
| smimport
(Simscape Multibody)