Package: seaplan
Seagoing mission planning based on station positions and occupation timesOverviewReads in a parameter file  (YAML format) containing variables
and a list of actions to perform.The parameter file can also specify a “station file” containing the names, latitudes
and longitudes of the stations.  All of these stations will be plotted on the map and
if an action has the same name and no specified latitude and longitude, this station’s
position will be used.Outputs a table of actions and predicted (or specified) times in HTML format.Parameter fileThe value between the field name and the comment below is the default value
(if the field is notentered) or the [type] to use to fill in this field:---format_version:[string]# seaplan major version number ("0.4")description:[string]# Will be printed at the top of the outputvariables:station_file:# NOT REQUIREDname:''# CSV file containing the station positionsfield_separator:";"# CSV field separatorprintout:# NOT REQUIREDshow_comments:False# Print comments in output tableprint_past:True# Print past events (date before UTC.now())timing:ignore_depart_arrive_times:False# Calculate all times, ignoring explicit Event valuesship_speed.kn_i:11.# Ship speed in transit between stationsship_latency.h:0.5# Add this time to each transit to account for acceleration/decelerationaction_times.h:# Default times for each listed action"{Action1}":# First Action type"{TYPE1}":[float]# Station type and default time"{TYPE2}":[float]# Station type and default timedefault:[float]]# default time for non-specified station type"{Action2}":# Second Action type...map:grid:x:1.# Plot grid longitude spacing in decimal degreesy:1.# Plot grid longitude spacing in decimal degreesbounds:[float,float,float,float]# plot bounds in degrees [left, right, bottom, top]   # degrees left, right, bottom, topbathy_map:[str]# Path to netCDF bathy/topo map to plotplot_past_tracks:True# Plot tracks make prior to UTC.now()show_plot:True# plot map to screenevents:# List of events to plot-station:[str]# Station name: if found in station_file, will get coordinates from therelat:[float]# Station latitude  (overwrites value in station_file, if any)lon:[float]# Station longitude  (overwrites value in station_file, if any)arrive_time:[ISO8601]# Fix arrival time (otherwise uses previous depart_time+transit+latency)depart_time:[ISO8601]# Fix depart time (otherwise uses arrive_time + hours)hours:[float]# Time spent on the operation.  If zero, the event# is considered to be a waypoint.  If not specified,# use action_time.h['{Action_type}']['{Station_TYPE}']# or action_time.h['{Action_type}']['default'],comment:[str]# Commentspeed:[float]# Speed between previous and given site (overrides ship_speed_knots)-station:# Station name...Here’s an example:---format_version:"0.4"description:"Locateallunlocated,deployallbycable"variables:station_file:name:'MayOBS_I_stations.csv'field_separator:";"printout:show_comments:Falseprint_past:Truetiming:ignore_depart_arrive_times:Falseship_speed.kn_i:11ship_latency.h:0.5action_times.h:"Deploy":"SP":0.25"BB":0.5default:0.5"Survey":default:2.0map:grid:x:0.2y:0.1bounds:[45,46,-13.1,-12.4]# degrees left, right, bottom, topbathy_map:'/Users/crawford/_Work/Figures_Etc/2_Maps/Mayotte/grd/MNT-global-Mayotte_netcdf.grd'#bathy_map: Trueplot_past_tracks:Trueshow_plot:Trueevents:-station:"MONH"arrive_time:2019-02-23T00:00action:"Recover"hours:1.5comment:"1h30mMAYOBS15sanssurvey,shouldbelocatedbySISMAORE1activeseismics"-station:"MOCH"action:"Recover"hours:1.7comment:"1h40mMAYOBS15,alreadywelllocated"-station:"MOSH"action:"Recover+survey:1200mrayon"hours:4.00comment:"2h45mMAYOBS15sanssurvey"-station:"MOAH"action:"Recover+survey:1700mrayon"hours:4.25comment:"2h20mMAYOBS15sanssurvey"-station:"MOBH"action:"Recover+survey:1600mrayon"hours:3.75comment:"1h45mMAYOBS15sanssurvey"-station:"MOBx"action:"Deploycable"hours:3.5-station:"MODH"action:"Recover"hours:2.6comment:"2h35mMAYOBS15sanssurvey,shouldbelocatedbySISMAORE1activeseismics."-station:"MODx"action:"Deploycable"hours:3.6-station:"MOAx"action:"Deploycable"hours:3.9-station:"MOSx"action:"Deploycable"hours:3.17-station:"MOCx"action:"Deploycable"hours:2.5-station:"MONx"action:"Deploycable"hours:2.7Station fileA CSV file who’s first line is a header that specifies the field order,
using the namesName,Lat,Lon,TypeandComment.  For example:Name;Lat;Lon;Type;Comment
MOAx;-12.9625;45.8199;SP;
MOBx;-12.8417;45.6250;SP;
MOCx;-12.7837;45.4113;SP;BUBBLEPHONE
MODx;-12.6710;45.5929;SP;
MONx;-12.5956;45.4091;SP;
MOSx;-13.0208;45.4585;SP;
MOAH;-12.9567;45.8192;SP;
MOBH;-12.8423;45.6210;SP;
MOCH;-12.7842;45.4110;SP;BUBBLEPHONE
MODH;-12.6707;45.5928;SP;
MONH;-12.5958;45.4090;SP;
MOSH;-13.0252;45.4557;SP;
Volc;-12.91755;45.71525;VOLC;New Volcano
SISN;-12.1;45.71525;SP;Active Survey station
SISS;-13.8;45.71525;SP;Active Survey stationMiscellaneous featuresPuts name of stations/actions on plot UNLESS they have no “hours” (just a
waypoint)Crosses out stations that have already been visited (departure_time entered
and before UTCDateTime.now()Changes the color of the ship’s track every time you use the action name “NEWLEG”Other subdirectoriesseaplan/_examples/Example files and scripts:UsereStructuredTextto modify this file.