Example 1: Getting Started

In this section, a simple example of a Near Field simulation will be shown. This simulation will be performed considering a cube as the geometry. An Ultrasound Source will be defined as an ultrasound pattern file (also called Annex 1: DUS File Format).

Step 1: The first step consists of creating a new data file where all the parameters of the simulation will be saved. Use the command New from the File menu. Select US type.

Figure 1. Selection Method dialog box


Step 2: The second step is to generate the box. Select GeometrySolidBox. It will be located at (0,0,0) and the dimensions are 1x1x1 m.

Figure 2. Create box


Figure 3. Box situated at (0,0,0)


Step 3: The next step is to set the main parameters of the simulations, which are located in Simulation Parameters Menu > Simulation.

A dialog appears. In this menu, the frequency, kind of simulation, speed of sound sweep, effects to calculate, and other parameters must be defined before running the simulation. In this example, a radiation pattern file in far field is simulated. The user will introduce:
  • Near field in Simulation Type.
  • The number of frequency points and the frequency in this example 1 and 50 kHz.
  • The Speed of Sound Sweep will be 340 m/s
  • The effect order will be 1.

The rest of the options are the default ones.

Figure 4. Parameters dialog box


Step 4a: To create a new ultrasound pattern file (.dus), select the Source menu → DUS Source Editor. The user can find more info about DUS Source format at Annex 1: DUS File Format.

In this case, an omnidirectional pattern file has been edited.

Figure 5. DUS file Editor


Step 4b: Import the ultrasound pattern (DUS file) to the current project. In this example, the user has to import the demo_DUSfile.dus file.

Figure 6. Import DUS file


Step 5: Define the position of the ultrasound pattern over the cube clicking on Source > Ultrasound Pattern.

Set the ultrasound pattern file. Click on the add button and add the previous imported file.

Set the Amplitude and Phase.

Set the position of the source on (0.5, 0.5, 1.2).

Figure 7. Ultrasound Pattern menu


Step 6: The next step is to define the position of the observations points. Select Observation points from Output menu. In Geometry Types dialog, select Plane and click on the Add button.





Step 7: To mesh the geometry click on Meshing > Create visibility matrix and select the number of processors.

Figure 8. Processors option for meshing


Figure 9. Mesh


Step 8: Execute the simulation by selecting Calculate > Execute and introduce the number of processors to be used.

Figure 10. Processors options for Execute


Figure 11. Execute


Step 9: After obtaining the results, choose view ray from show results. It is possible to visualize order 1 rays. It is possible to represent the ray tracing interacting with the geometry.

Figure 12. Ray Viewer dialog box


Step 9: It is possible to select a ray to show its information. Clicking in one of the ray will fill its information in the bottom of the panel.

Figure 13. Viewing the ray information


Step 10: To visualize the charts click on Show Results > Near Field > View Cuts, after which the following dialog will be shown:

Figure 14. Near field