Prelude | A Quick Start for the Impatient User
Introduction
Thank you for your interest in Virtual CRASH software! You’ll find that Virtual CRASH is an extremely powerful and versatile simulation tool, which can be quickly mastered [1]. This prelude is designed for users (or trial version testers) eager to dive into the Virtual CRASH environment and start manipulating vehicles. You will learn how to select a car from the gallery browser and import it into the scene. You’ll also discover how to set up a simulation and attach a vehicle to an animation path. First, let’s cover a few basic aspects of the user interface.
Virtual CRASH 4
This User’s Guide is intended for Virtual CRASH 3 users. Notice, many of the workflows are the same as those found in Virtual CRASH versions 4, 5, and 6.
Trial Version Limitations
If you have not yet purchased a license of Virtual CRASH software, you will notice the application launches in “trial” mode. You’ll see “trail version” at the top of the application window. Please note, the trial version of Virtual CRASH is designed to give you a feel for its most important features and functions; as such, many features and functions are disabled. You will not be able to save projects, create videos, modify vehicle parameters, among others. While you can experiment with our “generic” vehicle and human figures (multibodies), changing weights and geometrical input data is not possible.
USB Dongle
For each license of Virtual CRASH that is purchased, your organization will receive a physical USB dongle (“license key”). Note, this is not a hardware storage device, but a “key” to unlock Virtual CRASH software functionality. We require that Virtual CRASH software be installed locally on the same Windows desktop or laptop computer to which the display (monitor(s)) and user input devices (mouse and keyboard) used to operate Virtual CRASH are directly connected. The USB dongle must be plugged into this exact same local computer and cannot be used on a remote machine or through a network connection (see EULA). USB-to-IP Windows applications can disrupt the proper functioning of the Virtual CRASH USB dongle and may cause Virtual CRASH to launch only in trial mode. With the trial version launched, once a USB dongle is plugged into the user’s machine, all functionality will be enabled.
Changing Themes
You can change the theme used by Virtual CRASH 3 by going to Window > Theme. The theme used for the images below is “Classic”.
Unit Preferences
When you first start Virtual CRASH 3, speed units are set to kilometers per hour, length in meters, and mass/weight in kilograms. To change the units, simply left-click on the “units” menu in the left-side control panel. Then, left-click on the type of parameter (velocity (speed), metric (length), mass (weight)) to access the dropdown menu, and select the desired unit. These preferences will be automatically saved for future sessions.
Camera Basics
When you first launch Virtual CRASH, the mouse cursor will start in “Pan” mode. “Pan” mode allows you to move the camera carefully throughout the scene, ensuring that you don’t accidentally disturb a simulation by moving or reorienting objects in a project. You will know you are in “Pan” mode when the white glove icon appears in the workspace. With this icon visible, hold+left-click and drag to translate the camera, and hold+right-click and drag to rotate the camera. Use your mouse’s scroll wheel to zoom in and out.
Additional Training Content
You can find additional training content online at http://www.vcrashusa.com/academy. There you will find Blog posts, Knowledge Base posts, and training videos all of which are important to learn the numerous features and functions of Virtual CRASH. Users are strongly recommended to review all this content on the academy.
Self-Paced Training
Another great way to quickly learn Virtual CRASH fundamentals is by enrolling in our Self-Paced Training courses. In our Self-Paced Training you will receive video lectures specifically made for each course, as well as refreshers of content that can be found on the vCRASH Academy. After watching and reading through the course material, you will be given quizzes and class projects. The class projects are graded by our expert instructors. To learn more about Self-Paced Training go to: http://www.vcrashusa.com/self-paced-training.
The Virtual Tutor
The first thing you should familiarize yourself with in Virtual CRASH is the innovative “Virtual Tutor” feature [2]. The Virtual Tutor will help you understand where to access most of the functions within Virtual CRASH by literally taking over your mouse and showing you! To access the Virtual Tutor help topics, go to the lower portion of the left-side control panel and left-click on “help”.
Now you should see a list of topics from which you can select. Note, the “player speed” option is above the list, and can be used to slow down or speed up the lessons.
Next, select your lesson by left-clicking a topic and watch.
Select a Vehicle and Place it into the Scene
To place a vehicle into the scene, first left-click on "vehicle" in the left-side control panel. This action will open the gallery browser. The vehicle database browser contains a list of all 3D vehicles that can be placed within the scene [2]. For trial version users, the vehicle database browser can also be used to see what vehicles come with Virtual CRASH.
Once you left-click on “vehicles” you will see the browser shown below.
Given that the database holds definitions for a wide range of vehicles, some of which lack unique mesh geometries, you might consider using a filter to display only those vehicles that have a distinct geometry (for details, see https://www.vcrashusa.com/kb-vc-article36). The steps for applying the filter are shown in the video below.
Move your mouse to the left side control panel, and left-click the “+” sign next to “car” to reveal the vehicle makes list.
Next, using either your mouse’s scroll wheel, or the scroll bar, scroll down the list until you find the desired vehicle make, then press the “+” sign to reveal the available models. If there is a “+” sign next to the model, left-click to expand the list.
Hold+left-click on the vehicle name, then drag your cursor into the workspace and release the left button. An instance of the vehicle should appear in the workspace. Using this method, you can create as many instances of the vehicle as needed (cloning vehicles is discussed in other chapters). After you have finished placing vehicles in the scene, left-click on "edit".
Note, by hovering over the vehicle’s name, you can see various specifications, including the vehicle’s year. Remember, overall dimensions, wheel placement, inertial properties, and CG location can all be changed as needed.
Below is the trial version’s “generic” vehicle. You are limited to using only this vehicle in the trial version. Without a USB dongle plugged into your machine, all vehicles imported into the Virtual CRASH workspace will appear like the one shown below.
Press [Ctrl+7] on your keyboard, or use select “Smooth + Texture” from the render mode menu to improve the appearance of your project as it appears in your interactive workspace. Finally, left-click on the large “edit” button to exit the gallery browser.
Simulation
INPUT VEHICLE POSITION
Simulated vehicle controls are fully explained in the User’s Guide. Below, we’ll provide a brief explanation for inputting speed and steering inputs into a simulated vehicle. Again, in the trial version, you will be limited to the “generic” vehicle. To simulate vehicle motion, first change your mouse cursor control to "Select And Move". Then, left-click on the name of your vehicle in the project menu on the left to select it, or you can left-click directly on the vehicle object within the workspace. Next, hold+left-click near the center of the vehicle’s bounding box to reposition the vehicle.
To translate the vehicle, hover your mouse near the center of the vehicle’s bounding box in the workspace. Then, hold+left-click and move your mouse to reposition the vehicle within the workspace, and release the click once it's in the desired position.
NPUT ORIENTATION
To rotate the vehicle, hover your mouse near a corner of the vehicle’s bounding box in the workspace. Then, hold+left-click and move your mouse upward or downward to rotate the vehicle.
INPUT INITIAL SPEED
Left-click on the "dynamics" menu in the left-side control panel. You can set the vehicle’s initial speed using the "v (t=0s)" input field. Left-click in the box to the right of this label, type in the initial speed, and press enter. The simulation will instantly refresh, showing the time-forward projected path of the vehicle with a red center-of-gravity line, as well as gray rectangles called "interpositions".
Alternatively, as with many input fields, you can left-click on the down arrow to the right of the input field to open the horizontal slider. Once the slider is open, hover your mouse cursor over it. Then, hold+left-click on the slider button and move your mouse left or right to interactively change the input value. You can also use your mouse’s scroll wheel while your cursor is hovering over the horizontal slider window. When active, the window will change colors to indicate its active state.
INPUT DRIVER ACTIONS
Left-click on "dynamics" to close the menu. Then, left-click on "sequences" to open the "sequences" menu, where driver actions can be programmed. Left-click on "add sequence" to input the first driver action. Clicking the "add sequence" button will add an entry to the sequences list, with the default type being "deceleration" (note: sequence types are explained in subsequent chapters). The first entry in this list always relates to the initial driver action, starting at simulation time = 0 seconds. In the example below, we modify the steering angle using the "steering" input field, enabling the driver to initiate a right steering maneuver starting at time = 0 seconds. The "steering time" is the duration for the steering angle to reach the new target angle (note: the default value is always 1 second). In this example, it takes 1 second for the steering angle to change from 0 degrees to -8 degrees at the axle.
Next, we’ll activate the brakes by adding a second sequence. Do this by clicking the "add sequence" button. Then, use the down arrow to interactively adjust the "pedal position" (which represents the percentage of full braking) to decelerate the vehicle.
Note that as you modify any of the sequence inputs, the simulation will instantly refresh, providing an updated time-forward trajectory prediction.
Since the sequence is of "type: deceleration", increasing the "pedal position" input value will decelerate the vehicle. Conversely, if the type is set to "type: acceleration", the "pedal position" will cause the vehicle to accelerate.
You have the flexibility to add as many sequence entries as necessary for your simulation. Additionally, you can left-click on any entry in the sequences list to adjust the various input values as required. The simulation will automatically update to reflect these changes.
SEQUENCE INPUTS USING FAST-CONTROL ICONS
An alternative to manually inputting sequence entries is to use the fast-control icon input option. To utilize this feature, switch your mouse cursor control to "Select, Move And Manipulate" (or press [F3]). Then, hover over the interposition where you want the driver to initiate the new action and left-click. This action will snap the time-slider to the moment corresponding to the vehicle's position where you clicked. You should then see yellow icons appear.
Hold+left-click on the steering wheel fast control icon to simultaneously change the "steering time" and "steering" input values. Notice that as soon as you move the steering wheel fast-control icon, a sequence is automatically placed in the sequences list. As you move the icon, the trajectory prediction will refresh automatically, and the input values in the corresponding sequence entry will update automatically.
To input another driver action, hover your cursor over the interposition where you want the action to begin and left-click. You will once again see fast-control icons appear. In this example, we used hold+left-click to move the "pedal position" fast-control icon backward, initiating a braking action at that position. Notice that a third sequence entry is automatically placed in the sequences list. The "pedal position" input value for this entry will change as you move the pedal position icon.
Additionally, at each position where a driver action starts, a gray bounding box becomes visible. Each of these bounding boxes corresponds to a specific sequence entry in the sequences list.
Again, you are free to click on any entry in the sequence list to modify the various input values as needed. Additionally, you can left-click on any of the gray bounding boxes to access the corresponding sequence entry. Doing so will reveal the fast-control icons, which you can adjust as needed to fine-tune the simulated motion of the vehicle.
Adjusting Time of Driver Action
The position in space or the corresponding moment in time at which a given action begins is determined by the "time" input value of the sequence entry. "Time" represents the duration after the start of the previous sequence entry when the driver initiates the new action. The first sequence entry always begins at time = 0 seconds. The "time" values for all other sequences can be adjusted as needed by modifying the "time" input field. Additionally, "time" can be interactively adjusted using the "I" fast-control icon. Simply hold+left-click on the "I" icon and drag your cursor backward or forward along the vehicle’s trajectory.
Additional Information for Trial Version Users
You can find additional information about typical Virtual CRASH workflows below. If you are using the trial version (without a USB dongle plugged into your machine), please remember while you can experiment with some aspects of the functionality described in the links below, you will not be able to take full advantage of the features until you purchase a full license.
Other important aspects of the Virtual CRASH interface >
Importing total station and RTK Data >
Physics Tests for Trial Version Users
If you are still test driving the Virtual CRASH trial version, we invite you to head over to the Trial Version Analyses Quick Reference Page to find various videos exploring aspects of the underlying Virtual CRASH physics engine. Note, these videos were made in previous version of Virtual CRASH, but the workflows and interface related to physics inputs are exactly the same as in Virtual CRASH 3.
Additional Training Content
You can find additional training content online at http://www.vcrashusa.com/academy. There you will find Blog posts, Knowledge Base posts, and training videos all of which are important to learn the numerous features and functions of Virtual CRASH. Users are strongly recommended to review all this content on the academy.
Self-Paced Training
Another great way to quickly learn Virtual CRASH fundamentals is by enrolling in our Self-Paced Training courses. In our Self-Paced Training you will receive video lectures specifically made for each course, as well as refreshers of content that can be found on the vCRASH Academy. After watching and reading through the course material, you will be given quizzes and class projects. The class projects are graded by our expert instructors. To learn more about Self-Paced Training go to: http://www.vcrashusa.com/self-paced-training.
Live Training
We offer many live training opportunities throughout the year. Check our calendar for upcoming classes. Check calendar >
Backward Compatibility
Virtual CRASH 3 cannot open any files from prior versions.
Forward Compatibility
Virtual CRASH 3 does not open files from Virtual CRASH 4, 5, 6, or Public Safety.
Notes:
[1] When using any physics simulation software tool, it is imperative the user perform all necessary consistency checks to ensure the simulated results are in good agreement with expectations from standard forensic techniques. It is also imperative the user understand the limitations of the simulation tool, as well as understand potential sources of uncertainties in simulated results, including but not limited to, user uncertainties in input parameters as well as those related to object positions and orientations within the simulation environment.
[2] It is recommended to always consult this list first before starting a project to find the best matches for your subject vehicles. Note, it is also recommended that you ensure all vehicle properties, including size, inertial properties, wheel placement, drive axle, etc, are properly set using appropriate values for your subject vehicles. Vehicle properties can be obtained through third-parties such as the Canadian Vehicle Specifications database (http://www.carsp.ca/research/resources/safety-sources/canadian-vehicle-specifications/), Expert Autostats (http://www.4n6xprt.com/), or Lightpoint Scentific (http://lightpointdata.com/).
Tags: Quick start, vni, vnz, omega-z, how to watch tutorial, virtual tutor, make a vehicle, put vehicle in scene, how to create simulation.
© 2024 Virtual CRASH, LLC. All Rights Reserved