bft_user_guide.html

来自「超声仿真软件」· HTML 代码 · 共 1,222 行 · 第 1/5 页

<p>

<TaBle>
<tr><td>USAGE: </td><td width="553"><tt>bft_center_focus(point, line_no)</tt> </td>
<tr><td>INPUT: </td><td width="553">
<TaBle>
<tr><td><i>point</i> </td><td width="434">The center point [x,y,z]              [ m ]</td>
<tr><td><i>line_no</i> </td><td width="434">Number of line. If omitted in the parameter
                    list <i>line_no</i> is assumed equal to 1</td></TaBle>
</td>
<tr><td>OUTPUT: </td><td width="553">None
</td></TaBle>

<p>

<title> bft\_dynamic\_focus</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_dynamic_focus</H3>
<hr>

  <A NAME="bft_dynamic_focus">
</A>
  <a name="bft_dynamic_focus"></a>

<p>
Set dynamic focusing for a line

<p>

<TaBle>
<tr><td>USAGE: </td><td width="553"><tt>bft_dynamic_focus(xdc, dir_xz, dir_zy, line_no)</tt> </td>
<tr><td>INPUT: </td><td width="553">
<TaBle>
<tr><td><i>xdc</i>  </td><td width="434">Pointer to the transducer aperture</td>
<tr><td><i>dir_zx</i> </td><td width="434">Direction (angle) in radians for the dynamic
                    focus. The direction is taken from the center for
                    the focus of the transducer in the z-x plane.</td>
<tr><td><i>dir_zy</i> </td><td width="434">Direction (angle) in radians for the dynamic
                    focus. The direction is taken from the center for
                    the focus of the transducer in the z-y plane.</td>
<tr><td><i>line_no</i> </td><td width="434">Number of line. If skipped, <i>line_no</i> is assumed
                    to be equal to '1'.
           </td></TaBle>
 </td>
<tr><td>OUTPUT: </td><td width="553">None 
</td></TaBle>
  
<p>

<title> bft\_end</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_end</H3>
<hr>

  <A NAME="bft_end">
</A>
  <a name="bft_end"></a>

<p>
Release all resources allocated by the beamforming toolbox.

<p>

<TaBle>
<tr><td>USAGE:</td><td width="553"><tt>bft_end</tt></td>
<tr><td>INPUT:</td><td width="553">None</td>
<tr><td>OUTPUT:</td><td width="553">None</td></TaBle>


<p>

<title> bft\_focus</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_focus</H3>
<hr>

  <A NAME="bft_focus">
</A>
  <a name="bft_focus"></a>

<p>
Create a focus time line.

<p>

<TaBle>
<tr><td>USAGE: </td><td width="553"><tt>bft_focus(xdc, times, points, line_no)</tt></td>
<tr><td>INPUT:</td><td width="553">
<TaBle>
<tr><td><i>xdc</i>    </td><td width="434">Pointer to aperture.</td>
<tr><td><i>times</i>  </td><td width="434">Time after which the associated focus is valid </td>
<tr><td><i>points</i> </td><td width="434">Focus points. Vector with three columns (x,y,z) 
                           and one row for each field point. </td>
<tr><td><i>line_no</i> </td><td width="434">Number of line for which we set the focus. If 
                     skipped, <i>line_no</i> is assumed equal to '1'.</td></TaBle>
 </td>
<tr><td>OUTPUT: </td><td width="553">none
</td></TaBle>

<p>

<title> bft\_focus\_times</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_focus_times</H3>
<hr>

  <A NAME="bft_focus_times">
</A>
  <a name="bft_focus_times"></a>

<p>
 Create a focus time line.
    The user supplies the delay times for each element.

<p>

<TaBle>
<tr><td>USAGE:</td><td width="553"><tt>bft_focus_times(xdc, times, delays, line_no)</tt></td>
<tr><td>INPUT:</td><td width="553">
<TaBle>
<tr><td><i>xdc</i>  </td><td width="434">Pointer to a transducer aperture. </td>
<tr><td><i>times</i> </td><td width="434">Time after which the associated delay is valid. </td>
<tr><td><i>delays</i> </td><td width="434">Delay values. Matrix with one row for each
                    time value and a number of columns equal to the
                    number of physical elements in the aperture. </td>
<tr><td><i>line_no</i> </td><td width="434">Number of line. If skipped, <i>line_no</i> is 
                          assumed to be equal to 1.
          </td></TaBle>
</td>
<tr><td>OUTPUT: </td><td width="553">None
</td></TaBle>
 
<p>

<title> bft\_free\_xdc</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_free_xdc</H3>
<hr>

  <A NAME="bft_free_xdc">
</A>
  <a name="bft_free_xdc"></a>

<p>
Free the memory allocated for a transducer definition

<p>

<TaBle>
<tr><td>USAGE:</td><td width="553"><tt>bft_free_xdc(xdc)</tt></td>
<tr><td>INPUT:</td><td width="553"><i>xdc</i> Pointer to the memory location returned by the
                 function <a href="#bft_transducer">bft_transducer</a></td>
<tr><td>OUTPUT:</td><td width="553">Nothing
</td></TaBle>

<p>

<title> bft\_init</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_init</H3>
<hr>

  <A NAME="bft_init">
</A>
  <a name="bft_init"></a>

<p>
Initialize the BeamForming Toolbox. This command must be
    executed first in order to set some parameters and allocate the 
    the necessary memory
    
<p>

<TaBle>
<tr><td>USAGE:</td><td width="553"><tt>bft_init</tt></td>
<tr><td>INPUT:</td><td width="553">None </td>
<tr><td>OUTPUT:</td><td width="553">None
</td></TaBle>

<p>

<title> bft\_linear\_array</title>

<br><br><br><br><br>
<p>
<hr>

<H3>bft_linear_array</H3>
<hr>

  <A NAME="bft_linear_array">
</A>
  <a name="bft_linear_array"></a>

<p>
 Create a linear array aperture.
 
<p>

<TaBle>
<tr><td>USAGE: </td><td width="553"><tt>xdc = bft_linear_array(no_elements, width, kerf)</tt> </td>
<tr><td></td><td width="553"><tt>xdc = bft_linear_array(no_elements, pitch)</tt> </td>
<tr><td>INPUT:</td><td width="553">
<TaBle>
<tr><td><i>no_elements</i> </td><td width="434">Number of elelements in the array </td>
<tr><td><i>pitch</i> </td><td width="434">Distance between the centers of two elements [m] </td>
<tr><td><i>width</i> </td><td width="434">Width in x-direction                         [m]</td>
<tr><td><i>kerf</i>  </td><td width="434">Distance between two elements                [m] 
         </td></TaBle>
 </td>
<tr><td></td><td width="553">The function assumes that <i>kerf + width = pitch</i> </td>
<tr><td>OUTPUT:</td><td width="553"><i>xdc</i> - Pointer to the allocated aperture.
</td></TaBle>

<p>

<title> bft\_no\_lines</title>

<br><br><br><br><br>
<p>