clearance create
Creates a new clearance study. There are two kinds of clearances in Adams, Run-time clearances and Post-processing clearances. Use the menu items Tools → Clearance→ Create in Adams PostProcessor, to create a clearance study for post-processing clearance.
Format:
clearance create |
|---|
clearance_name = | string |
comments = | string |
i_geometry = | existing geometry |
i_part = | existing part |
i_flex = | existing flexible body |
j_geometry = | existing geometry |
j_part = | existing part |
j_flex = | existing flexible body |
i_region = | existing matrix |
j_region = | existing matrix |
i_exclude = | boolean |
maximum = | real |
threshold = | real |
method = | selection list |
run_time = | boolean |
Example:
clearance create & |
|---|
clearance_name = | .testdb.CLEARANCE_1 & |
comments = | " test comment for post-processing clearances " & |
i_geometry = | LINK_2 & |
j_geometry = | BOX_1 & |
maximum = | 90 & |
method = | polygon |
clearance_name = | .testdb.CLEARANCE_run_time & |
comments = | " test run-time clearance comment" & |
i_flex = | FLEX_BODY_1,FLEX_BODY_2 & |
j_geometry = | BOX_1 & |
i_region = | MATRIX_1,MATRIX_2 & |
i_exclude = | no,yes & |
threshold = | 20 & |
run_time = | yes |
Description:
Parameter | Value Type | Description |
|---|
clearance_name | String | Specifies the name of the clearance study. |
comments | String | Any accompanying extra information that the user wishes to store with the clearance study. |
i_geometry | Existing Geometry | The first selected entity if it is a geometry. |
i_part | Existing Part | The first selected entity if it is a part. This option is only available for post-processing clearances. |
i_flex | Existing Flexible Body | The first selected entity if it is a flexible body |
j_geometry | Existing Geometry | The second selected entity if it is a geometry |
j_part | Existing Part | The second selected entity if it is a part. This option is only available for post-processing clearances.. |
j_flex | Existing Flexible Body | The first selected entity if it is a flexible body |
i_region | Existing Matrix | If the i_flex parameter is specified, then i_region parameter specifies the list of matrices to be excluded/included in the clearance computations. This option is only available for post-processing clearances. |
j_region | Existing Matrix | If the j_flex parameter is specified, then j_region parameter specifies the list of matrices to be excluded/included in the clearance computations. This option is only available for post-processing clearances. |
i_exclude | Boolean | A list of Boolean values that specifies whether the regions listed in the i_region parameter are to be excluded from the clearance computation. This option is only available for run-time clearances. |
j_exclude | Boolean | A list of Boolean values that specifies whether the regions listed in the j_region parameter are to be excluded from the clearance computation. This option is only available for run-time clearances. |
maximum | Real | To reduce the calculations in the clearance study, you can also define a maximum distance above which Adams PostProcessor does not calculate the clearance |
threshold | Real | For run-time clearances, specifies the threshold distance. When the clearance distance exceeds the threshold value, the precise check is skipped and the gross clearance value is returned. |
method | Selection List | The calculation method used by the Adams PostProcessor for clearance studies. |
run_time | Boolean | Specifies whether the clearance is a run-time clearance or not. If this parameter is not specified then the clearance is treated as a post-processing clearance. |
Extended Definition:
1. There are two distinct types of clearances supported in Adams, Run time clearances and Post Processing clearances. If the run_time parameter is not specified or specified as "no" then, the clearance is treated as a post-processing clearance. The parameters threshold, i_region, j_region, i_exclude and j_exclude are available only with run-time clearances. The parameters method and maximum are only available with post-processing clearances.
2. The information entered in the comments parameter is displayed as the title on the post-processing clearance plot which can be generated by the Adams Postprocessor.
3. Clearance can be found out between two bodies which can be parts, flexible bodies or geometries. If the first selected body happens to be a geometry, i_geometry should be selected as the parameter which holds the first body for clearance create.
4. Clearance can be found out between two bodies which can be parts, flexible bodies or geometries. If the second selected body happens to be a geometry, j_geometry should be selected as the parameter which holds the second body for clearance create.
5. Clearance can be found out between two bodies which can be parts, flexible bodies or geometries. If the first selected body happens to be a part, i_part should be selected as the parameter which holds the first body for clearance create.
Note: | Clearances between parts is allowed only for post-processing clearances. |
6. Clearance can be found out between two bodies which can be parts, flexible bodies or geometries. If the second selected body happens to be a part, j_part should be selected as the parameter which holds the second body for clearance create.
Note: | Clearances between parts is allowed only for post-processing clearances. |
7. Clearance can be found out between two bodies which can be parts, flexible bodies or geometries. If the second selected body happens to be a flexible body, i_flex should be selected as the parameter which holds the second body for clearance create.
Note: | Only a single flexible body can be specified for post-processing clearance whereas multiple flexible bodies separated by commas, can be specified for run-time clearances. |
8. Clearance can be found out between two bodies which can be parts, flexible bodies or geometries. If the second selected body happens to be a flexible body, j_flex should be selected as the parameter which holds the second body for clearance create.
Note: | Only a single flexible body can be specified for post-processing clearance whereas multiple flexible bodies separated by commas, can be specified for run-time clearances. |
9. To reduce the calculations in the clearance study for post processing clearances, you can also define a maximum distance above which Adams PostProcessor does not calculate the clearance. When you play an animation, if the distance between the pair of objects is greater than the maximum distance specified by you, Adams PostProcessor does not display a line between the objects. In addition, in the clearance study reports, if the distance between two selected bodies exceeds the maximum distance specified by you, Adams PostProcessor records the distance as the maximum distance and not the actual distance.
10. For run-time clearances, the threshold parameter specifies a double precision distance. If the gross clearance check is greater than this value, then the precise check is skipped and the gross value is returned. By default, the threshold parameter has value 0.0, indicating that the precise check is always to be done.
11. Adams PostProcessor uses two different calculations for clearance studies - polygon and vertex.
♦Polygon
In the Polygon method, Adams PostProcessor calculates the minimum distance between the surfaces of the triangles that make up the geometry. This is the most accurate method but requires the most time and calculations. See also, Vertex.
♦Vertex
In Vertex method, Adams PostProcessor calculates only the minimum distances between the vertices of the triangles that make up the geometry. This method is less accurate than Polygon, but calculates faster.