/*!

\page essay03  New Command:  Rover_Initalize

<hr>


New Command:  Rover_Initalize

To facilitate parameter tweaking and switching of the plan without a need to change the 
internals of the model, the IDEA team would like to request the addition of the following 
command to the MA interface. This command does not need to be integrated with the voice 
look, it is just something that will make our life immensely easier during testing (we 
will actually not have to mess with the model, something we dont want to do once we 
start freezing the code).
 
\li The new command has the following XIDDL interface. I will be available to give information 
on how to translate this into the appropriate IPC command but hopefully experience with the 
other commands should transfer to this one.
 
\li Command: Rover_Initialize
Class: AstronautInterface_Class
Timeline: Commands
 
        <define_procedure>
            <name>Rover_Initialize</name>
            <doc>Tells the rover to initialize itself according to the given parameters.</doc>
            <call_args>
               <arg>
                 <type>Integer</type>
                 <name>telemetryPeriodLB</name>                   <!-- ARG NUMBER: 1 -->
               </arg>
               <arg>
                 <type>Integer</type>
                 <name>telemetryPeriodUB</name>                   <!-- ARG NUMBER: 2 -->
               </arg>
               <arg>
                 <type>Real</type>
                 <name>navGoalAchievementTolerance</name>         <!-- ARG NUMBER: 3 -->
               </arg>
               <arg>
                 <type>String</type>
                 <name>inspectionPlanFileName</name>              <!-- ARG NUMBER: 4 -->
               </arg>
            </call_args>
 
            <return_status>
                <type>CompletionStatus</type>
                <name>status</name>                               <!-- ARG NUMBER: 5 -->
                <flag>statusFlag</flag>                           <!-- ARG NUMBER: 6 -->
            </return_status>
 
            <internal_modes>
                <mode type="successor_selector">
                    <doc>Used by compatibilities to select next token.</doc>
                    <type>CommandConnector</type>                 <!-- ARG NUMBER: 7 -->
                    <name>successor</name>
                </mode>
            </internal_modes>
            <call_args>
                <arg>
                   <type>Integer</type>
                   <name>default_panorama_n_images</name>         <!-- ARG NUMBER: 8 -->
                </arg>
                <arg>
                   <type>Real</type>
                   <name>default_panorama_last_pan_angle</name>   <!-- ARG NUMBER: 9 -->
                </arg>
                <arg>
                   <type>Real</type>
                   <name>default_panorama_tilt_angle</name>       <!-- ARG NUMBER: 10 -->
                </arg>
                <arg>
                   <type>Real</type>
                   <name>default_panorama_delta_pan_angle</name>  <!-- ARG NUMBER: 11 -->
                </arg>
            </call_args>
        </define_procedure>
 
\li As usual you only need to worry with the call args (when you send them to IDEA) in the order 
in which they appear, never mind if the sequence is interrupted by return-status or internal 
modes parameters.

\li The return status is of the usual type (like all other commands you have provided so far).
 
\li The String for the filename has to be a string without double quote with the location of 
the plan file (either full or relative to the directory from where the IDEA agent is 
launched).  We will provide you with the plan file(s) as soon as we build good ones.
 
<hr>

*/
