The MaxDepth Behavior


Maintained by: mikerb@mit.edu         Get PDF


src: project-pavlab/bhvdocs/bhv_max_depth


1  The MaxDepth Behavior
     1.1 Configuration Parameters
     1.2 Variables Published
     1.3 The MaxDepth Objective Function

1   The MaxDepth Behavior


This behavior will drive the vehicle within a configured depth tolerance. This behavior merely expresses a preference for a particular depth. If other behaviors also have a depth preference, coordination/compromise will take place through the multi-objective optimization process.

This behavior differs from the maximum depth in the OpRegion or newer OpRegionV24 behavior In the MaxDepth behavior, an objective function is produced to prevent the vehicle from exceeding the maximum depth, perhaps tempering other behaviors that may prefer deeper depths. In the OpRegionV24 behavior there is no attempt to influence the vehicle depth, but rather only to monitor the observed depth and produce an error if the depth is exceeded.

The following parameters are defined for this behavior:

1.1   Configuration Parameters    [top]


Listing 1.1 - Configuration Parameters Common to All Behaviors.

activeflag:A MOOS variable-value pair posted when the behavior is in the active state. [more].
condition:Specifies a condition that must be met for the behavior to be running. [more].
duration:Time in behavior will remain running before declaring completion. [more].
duration_idle_decay:When true, duration clock is running even when in the idle state. [more].
duration_reset:A variable-pair such as MY_RESET=true, that will trigger a duration reset. [more].
duration_status:The name of a MOOS variable to which the vehicle duration status is published. [more].
endflag:A MOOS variable-value pair posted when the behavior has completed. [more].
idleflag:A MOOS variable-value pair posted when the behavior is in the idle state. [more].
inactiveflag:A MOOS variable-value posted when the behavior is not in the active state. [more].
name:The (unique) name of the behavior. [more].
nostarve:Allows a behavior to assert a maximum staleness for a MOOS variable. [more].
perpetual:If true allows the behavior to to run even after it has completed. [more].
post_mapping:Re-direct behavior output normally to one MOOS variable to another instead. [more].
priority:The priority weight of the behavior. [more].
pwt:Same as priority.
runflag:A MOOS variable and a value posted when a behavior has met its conditions. [more].
spawnflag:A MOOS variable and a value posted when a behavior is spawned. [more].
spawnxflag:A MOOS variable and a value posted when a behavior is spawned. [more].
templating:Turns a behavior into a template for spawning behaviors dynamically. [more].
updates:A MOOS variable from which behavior parameter updates are read dynamically. [more].

Listing 1.2 - Configuration Parameters for the MaxDepth Behavior.

ParameterDescription
basewidth:The width of the base, in meters, in the produced ZAIC-style IvP function. Section 1.3.
max_depth:The maximum allowable depth of the vehicle, in meters.
tolerance:Another way (alias) of setting the basewidth parameter Section 1.3.
depth_slack_var:Name of the MOOS variable indicating the present delta between the maximum depth and the current depth. Section 1.2.

Listing 1.3 - Example Configuration Block.

 Behavior = BHV_MaxDepth
 {
   // General Behavior Parameters
   // ---------------------------
   name      = maxdepth
   pwt       = 1000
   condition = MODE==ACTIVE

   // Parameters specific to this behavior
   // ------------------------------------
         max_depth = 80              // example (meters)
         tolerance = 100             // default (meters)
   depth_slack_var = DEPTH_SLACK     // example
 }

1.2   Variables Published    [top]


The behavior may be optionally configured to publish a variable indicating the discrepancy between the maximum allowed depth and the actual observed depth. The MOOS variable is named using the depth_slack_var parameter. This variable will only be published when the behavior is in the running state.

1.3   The MaxDepth Objective Function    [top]


  • basewidth: The width of the base, in meters in the produced objective function. The default is 100. See Figure ??? for more on the basewidth parameter used in the ZAIC tool for building IvP functions.
  • tolerance: This is an alias, or another way of specifying the basewidth parametr.

Document Maintained by: mikerb@mit.edu        
Page built from LaTeX source using texwiki, developed at MIT. Errata to issues@moos-ivp.org. Get PDF