bht_kine_check page

Biohydrodynamics Toolbox    

bht_kine_check

Display the articulated bodies at their initial positions together with the fluid's boundaries.

Syntax

bht_kine_chek('DataFilename',filename1,'ControlsFilename',filename2)

bht_kine_check(...,'ControlsParameters',cont_parameters)

bht_kine_check(...,'axis',[xmin xmax ymin ymax])

Description

After the DAT-File has been compiled with bht_data_compile and before starting the computations by running bht_traject_compute, the function bht_kine_check allows you to check if most of your experiment's features described in the DAT-File comply with your expectations. 

The command line

>> bht_kine_chek('DataFilename',filename1,'ControlsFilename',filename2)

opens a GUI with a graphic window in which are displayed the articulated bodies and the fluid's boundaries, described in the DAT-File filename1, at the time t = 0. The articulated bodies are ploted at their initial positions and the links' labels (also given in the DAT-File) are displayed. The joint points are ploted as well. The GUI is endowed with four push buttons. The two firsts, labeled time + and time -, make the time increase or decrease and make the articulated bodies modify their shapes as prescribed by the controls M-File filename2. The third push button, labeled v, allows to display the velocity vectors (in red) at the center of mass of the solids and the fourth one, labeled gamma, allows to display the acceleration vectors (in blue).

When the controls M-File requires a parameters array cont_parameter, add to the previous statement the adequate optional field as follows:

>> bht_kine_check(...,'ControlsParameters',cont_parameters) 

You can also specify axis limits by adding the option 'axis':

 >> bht_kine_check(...,'axis',[xmin xmax ymin ymax])

BhT is not able to detect boundaries' overlaps which cause computations to crash. With bht_kine_check, you can make sure that all of the boundaries are disconnected, at least at the initial time.

GUI's view

Example of what a GUI displayed by bht_kine_check looks like:

See also

Articulated body

Fluid's boundaries

Controls M-File

Writing a DAT-File.

2008 - A. Munnier and B. Pincon (Insitut Elie Cartan and INRIA Lorraine, Projet CORIDA, Nancy, France).