Create Custom Results Output

Custom results output allows you to pass MotionSolve results directly to a user-written subroutine denoted by POST_SUB.

MotionSolve calls POST_SUB at every successful integration time step which uses the MotionSolve Result API for generating the results in a customized format. You have access to the same data as passed to the MotionSolve MRF file (shown here in HyperGraph) via POST_SUB, as shown in the image below.
Figure 1. HyperGraph Panel for POST_SUB Access


  1. Add the <Post_UserAPI/> element to the MotionSolve XML input file.
    Figure 2. <Post_UserAPI/> Element


  2. Write a POST_SUB:
    Figure 3. Code in POST_SUB


  3. From within POST_SUB, call access functions to get the states of selected entity types.
    These access functions are:
    • c_get_post_states
    • c_getnumid
    • c_getidlist

      as shown in the image below. Valid entity types are PART, POINT_MASS, FLEX_BODY, and REQUEST.

    Figure 4. POST_SUB's Three Access Functions


    The image below shows an example of the results accessed in POST_SUB in XML format:
    Figure 5. Results written out in XML Format