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_import
function generates.
The model must be on the MATLAB®path or already open prior to calling thevrphysmod
function.
The.wrl
extension is optional for a VRML virtual world file. If the specified system was created withSimscape MultibodyFirst Generationmech_import
function, you can specify also an.x3d
or.x3dv
file for thevirtualWorldFile
.
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 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 nodeDEF
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 modelfour_link
using the filefour_link.wrl
:
vrphysmod('four_link.wrl', 'four_link');
To update the subsystemfour_link/FOURLINK_ASM
using 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);