PK_check_fault_t   


typedef struct PK_check_fault_s
    {
    PK_check_state_t   state;      --- token indicating fault state
    PK_ENTITY_t        entity_1;   --- fault entity always present
    PK_ENTITY_t        entity_2;   --- secondary fault entity
                                   --- (may be PK_ENTITY_null)
    PK_VECTOR_t        position;   --- position within faulty volume
    } PK_check_fault_t;



This structure records a check fault.


Every check fault contains a state and entity_1.  Check faults may
contain an entity_2 and/or a position.  This depends upon the state as
shown in the following table.  If entity_2 is not used it is set to
PK_ENTITY_null, and if position is not used it is set to (0.0, 0.0, 0.0).

-------------------------------------------------------------------------------
|         state                |     `entity     |      position          |
|                                |   _1'  |   _2'  |                          |
-------------------------------------------------------------------------------
|PK_BODY_state_corrupt_c         |  body  |        |                          |
|PK_BODY_state_invalid_ident_c   |  body  |        |                          |
|PK_BODY_state_inside_out_c      |  body  |        |                          |
|PK_BODY_state_bad_regions_c     |  body  |        |                          |
|PK_EDGE_state_open_c            |  edge  |        |                          |
|PK_EDGE_state_open_nmnl_c       |  edge  |        |                          |
|PK_EDGE_state_bad_vertex_c      |  edge  | vertex |                          |
|PK_EDGE_state_bad_vertex_nmnl_c |  edge  | vertex |                          |
|PK_EDGE_state_reversed_c        |  edge  |        |                          |
|PK_EDGE_state_reversed_nmnl_c   |  edge  |        |                          |
|PK_EDGE_state_bad_spcurve_c     |  edge  |        |                          |
|PK_EDGE_state_bad_sp_nmnl_c     |  edge  |        |                          |
|PK_EDGE_state_vertices_touch_c  |  edge  |        |                          |
|PK_EDGE_state_bad_face_order_c  |  edge  |        |                          |
|PK_EDGE_state_bad_wire_ed_ed_c  |  edge  |  edge  | point in region of       |
|                                |        |        | inconsistency            |
|PK_ENTITY_state_invalid_c       | entity |        |                          |
|PK_FACE_state_bad_vertex_c      |  face  | vertex |                          |
|PK_FACE_state_bad_edge_c        |  face  |  edge  |                          |
|PK_FACE_state_bad_edge_order_c  |  face  |        |                          |
|PK_FACE_state_no_vtx_at_sing_c  |  face  |        | point at singularity     |
|PK_FACE_state_bad_loops_c       |  face  |        |                          |
|PK_FACE_state_self_int_c        |  face  |        | point in region of       |
|                                |        |        | inconsistency            |
|PK_FACE_state_bad_wire_fa_ed_c  |  face  |  edge  | point in region of       |
|                                |        |        | inconsistency            |
|PK_FACE_state_check_fail_c      |  face  |  face  |                          |
|PK_FACE_state_bad_face_face_c   |  face  |  face  | point in region of       |
|                                |        |        | inconsistency            |
|PK_GEOM_state_self_int_c        |  geom  |        | point on                 |
|                                |        |        | self-intersection        |
|PK_GEOM_state_degenerate_c      |  geom  |        | point in degenerate      |
|                                |        |        | region                   |
|PK_REGION_state_bad_shells_c    | region |        |                          |
|PK_SHELL_state_bad_topol_geom_c | shell  |        |                          |
|PK_SHELL_state_bad_sh_sh_c      | shell  | shell  | point in region of       |
|                                |        |        | inconsistency            |
|PK_TOPOL_state_not_G1_c         | topol  |        |                          |
|PK_TOPOL_state_size_box_c       | topol  |        |                          |
|PK_TOPOL_state_check_fail_c     | topol  |        |                          |
|PK_TOPOL_state_no_geom_c        | topol  |        |                          |
|PK_ATTDEF_state_bad_name_c      | attdef |        |                          |
|PK_ATTRIB_state_bad_string_c    | attrib |        |                          |
-------------------------------------------------------------------------------