HAS-Motion Software Documentation

This is an old revision of the document!

---

computeplanarangledialog.jpg |<code>\\ square_root\\ /signal_types=the type of signal to be evaluated\\ /signal_names=the name of the signal to be evaluated\\ /signal_folder=the name of the signal folder\\ /result_folder=the name of the resulting folder\\ /result_names=the name of the resulting signal \\ /compute_3pt_angle=(true=3pt, flase=4pt}\\ /normalx=the normal vector to the 3d angle\\ /normaly=\\ /normalz=\\ /reference_segment= lab\\ /projection_plane= xy\\ /use_right_hand_rule=true\\ /use_0_to_360_degrees=true\\ </code> | ---- ===== examples ===== ==== example 1: projected angles - 3 point ==== given targets labeled: **distal1**, **vertex**, and **distal2** and a segment **rft** project the angle onto one of the principal planes of the **rft** segment coordinate system. <code> ! compute the planar angle projected on the xy plane of the rft segment from 3 points (distal1, ! vertex, distal2). the resulting signal is named test_angle. the right hand rule is used and ! the angle is between -180 to 180 degrees. compute_planar_angle /signal_types=target+target+target /signal_names=distal1+vertex+distal2 /signal_folder=processed+processed+processed /result_name=test_angle /result_folder=angle /compute_3pt_angle=true ! /normalx= ! /normaly= ! /normalz= /reference_segment=rft ! /projection_plane=xy ! /use_right_hand_rule=true /use_0_to_360_degrees=false ; </code> ==== example 2: compute planar angle using transform segment coordinate system ==== this example transforms the targets **distal1**, **vertex**, **distal2** into the segment **rft** coordinate system and then computes the planar angle **test_angle**. <code> ! first transform the locations into the segment coordinate system transform_data_coordinate_system /signal_types=target+target+target /signal_names=distal1+vertex+distal2 /signal_folder=processed+processed+processed /from_segment_cs=lab /to_segment_cs=rft /result_type=target /result_folder=rft /result_suffix= ; ! compute the planar angle projected on the xy plane of the rft segment. compute_planar_angle /signal_types=target+target+target /signal_names=distal1+vertex+distal2 /signal_folder=rft+rft+rft /result_name=test_angle /result_folder=angle /compute_3pt_angle=true ! /normalx= ! /normaly= ! /normalz= ! /reference_segment=lab ! /projection_plane=xy ! /use_right_hand_rule=true /use_0_to_360_degrees=false ; </code> ==== example 3: projected angles - 4 point ==== given targets labeled: **prox1**, **prox2**, **distal1**, and **distal2** and a segment **rft** project the angle onto one of the principal planes of the **rft** segment coordinate system. <code> ! compute the planar angle projected on the yz plane of the rft segment from 4 points ! (prox1,prox2,distal1,distal2). the resulting signal is named test_angle. the right hand rule ! is used and the angle is between -180 to 180 degrees. compute_planar_angle /signal_types=target+target+target+target /signal_names=prox1+prox2+distal1+distal2 /signal_folder=processed+processed+processed+processed /result_name=test_angle /result_folder=angle /compute_3pt_angle=false ! /normalx= ! /normaly= ! /normalz= ! /reference_segment=lab /projection_plane=yz ! /use_right_hand_rule=true /use_0_to_360_degrees=false ; </code>