# seaplan
Seagoing mission planning based on station positions and occupation times
## Overview
Reads 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 with predicted (or specified) times. The table is in
MultiMarkdown format, it can be printed as is or converted to HTML, LaTeX etc for pretty
printing.
## Parameter file
The parameter file is divided into ``format_version``, ``parameters`` (can also
be called `variables` in v0.x) and ``events`` sections:
### format_version
Just a string that you should set equal your version of seaplan. Used to
check compatibility with newer/older versions
### parameters
Run parameters:
#### Required
- ``description``: Descriptive information to be printed in the HTML output file
- title: title text
- notes: an array of notes
- ``timing``:
- ``ship_speed.kn_i``: Cruising speed of the ship in knots. Used to
calculate transit times
- ``ship_latency.h``: Hours lost getting to speed from stopped. Added to
distance/ship_speed to calculate transit times
- ``ignore_depart_arrive_times``: Ignore ``'arrive_time'`` and
``'depart_time'`` in events (allows you
to test time predictions) [``False``]
- ``action_times.h``: Default hours for each action type, may further
be specifed to an action at a given station. Structure
is:
```
action_times.h:
"{action1}":
"{station_or_type1}": *float*
"{station_or_type2}": *float*
default: *float*
"{action_type2}":
default: *float*
```
- ``printout``: Controls what is printed in the output table:
- ``show_comments`` : Print comments
- ``show_waypoints`` : Print waypoints (events with ``hours=0``)
- ``print_past`` : Print past events
#### Optional
- ``station_file``: The name of a CSV file containing station information.
- ``name``: Name of CSV file
- ``field_separator``: single character
- ``map``:
- ``bounds``: plot bounds in Decimal degrees (MANDATORY unless you call
`seaplan --no_map``)
- ``grid``: grid spacing in decimal degrees
- ``coast_resolution``:
- '10m': 1/10,000,000 Natural Earth
- '50m': 1/50,000,000 Natural Earth
- '110m': 1/110,000,000 Natural Earth
- 'auto': Automatic Global Self-consistent, Hierarchical, High-resolution Geography (GSHHG) coastline resolution
- 'crude': GSHHG
- 'low': GSHHG
- 'intermediate': GSHHG
- 'high': GSHHG
- 'full': GSHHG
- bathy_map: Map background image [False]. Three possibilities:
* ``{string}``: Name of a netCDF file to plot as background image on the map
* ``True``: Plot an etopo image as background
* ``False``: No background map
- ``plot_past_tracks``: Plot past ship tracks
- ``show_plot``: Plot the the screen as well as a file
### events
A sequential list of "events". Each event can have the following parameters
- `station` (str): station name [MANDATORY]. If the name corresponds
to a "Name" in the station file, then the station
position, type and comments are read from there.
If not, you must specify at least `lat` and `lon` the
first time you name the station
- `lat` (float): station latitude [`station.lat` or 0.]
- `lon` (float): station longitude [`station.lon` or 0.]
- `arrive_time` (ISO): [previous `depart_time` + transit + `latency`]
- `depart_time` (ISO): [`arrive_time` + `hours`]
- `hours` (float): time spent on the operation. If zero, the event
is considered to be a waypoint. Defaults are (from highest to lowest priority):
- `action_time.h['{action}']['{station}']`,
- `action_time.h['{action}']['default']`,
- `0.`
- `comment` (str): comment
- `speed` (float): speed between previous and given site [`ship_speed.kn_i`]
## Station file
A CSV file whos first line is a header that specifies the field order, using
the following names:
- `Name`: station name
- `Lat`: station latitude
- `Lon`: station latitude
- `Type`: used to define default times
- `Comment`: station comment
## Miscellaneous features
- Puts 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 subdirectories
### `seaplan/_examples/`
Example files and scripts:
Use `reStructuredText
<http://docutils.sourceforge.net/rst.html>`_ to modify this file.
Raw data
{
"_id": null,
"home_page": "https://github.com/WayneCrawford/seaplan",
"name": "seaplan",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "oceanography,marine,OBS",
"author": "Wayne Crawford",
"author_email": "crawford@ipgp.fr",
"download_url": "https://files.pythonhosted.org/packages/fb/38/04639902c43ddb54cd8841440a2790ade5fdc82f4940b659d151bdfec313/seaplan-0.5.0.tar.gz",
"platform": null,
"description": "# seaplan\n\nSeagoing mission planning based on station positions and occupation times\n\n## Overview\n\nReads in a parameter file (YAML format) containing variables \nand a list of actions to perform.\n\nThe parameter file can also specify a \"station file\" containing the names, latitudes\nand longitudes of the stations. All of these stations will be plotted on the map and\nif an action has the same name and no specified latitude and longitude, this station's\nposition will be used.\n\nOutputs a table of actions with predicted (or specified) times. The table is in\nMultiMarkdown format, it can be printed as is or converted to HTML, LaTeX etc for pretty\nprinting.\n\n## Parameter file\n\n\nThe parameter file is divided into ``format_version``, ``parameters`` (can also\nbe called `variables` in v0.x) and ``events`` sections:\n\n### format_version\n\nJust a string that you should set equal your version of seaplan. Used to\ncheck compatibility with newer/older versions\n\n### parameters\n\nRun parameters:\n\n#### Required\n\n- ``description``: Descriptive information to be printed in the HTML output file\n - title: title text\n - notes: an array of notes \n\n- ``timing``:\n - ``ship_speed.kn_i``: Cruising speed of the ship in knots. Used to\n calculate transit times\n - ``ship_latency.h``: Hours lost getting to speed from stopped. Added to\n distance/ship_speed to calculate transit times\n - ``ignore_depart_arrive_times``: Ignore ``'arrive_time'`` and \n ``'depart_time'`` in events (allows you\n to test time predictions) [``False``]\n - ``action_times.h``: Default hours for each action type, may further\n be specifed to an action at a given station. Structure\n is:\n ```\n action_times.h:\n \"{action1}\":\n \"{station_or_type1}\": *float*\n \"{station_or_type2}\": *float*\n default: *float*\n \"{action_type2}\":\n default: *float*\n ```\n- ``printout``: Controls what is printed in the output table:\n - ``show_comments`` : Print comments\n - ``show_waypoints`` : Print waypoints (events with ``hours=0``)\n - ``print_past`` : Print past events\n\n#### Optional\n\n- ``station_file``: The name of a CSV file containing station information.\n - ``name``: Name of CSV file\n - ``field_separator``: single character\n\n- ``map``:\n\n - ``bounds``: plot bounds in Decimal degrees (MANDATORY unless you call\n `seaplan --no_map``)\n - ``grid``: grid spacing in decimal degrees\n - ``coast_resolution``:\n - '10m': 1/10,000,000 Natural Earth\n - '50m': 1/50,000,000 Natural Earth\n - '110m': 1/110,000,000 Natural Earth\n - 'auto': Automatic Global Self-consistent, Hierarchical, High-resolution Geography (GSHHG) coastline resolution\n - 'crude': GSHHG\n - 'low': GSHHG\n - 'intermediate': GSHHG\n - 'high': GSHHG\n - 'full': GSHHG\n - bathy_map: Map background image [False]. Three possibilities:\n\n * ``{string}``: Name of a netCDF file to plot as background image on the map\n * ``True``: Plot an etopo image as background\n * ``False``: No background map\n\n - ``plot_past_tracks``: Plot past ship tracks\n - ``show_plot``: Plot the the screen as well as a file \n \n### events\n\nA sequential list of \"events\". Each event can have the following parameters\n\n- `station` (str): station name [MANDATORY]. If the name corresponds\n to a \"Name\" in the station file, then the station\n position, type and comments are read from there.\n If not, you must specify at least `lat` and `lon` the\n first time you name the station\n- `lat` (float): station latitude [`station.lat` or 0.]\n- `lon` (float): station longitude [`station.lon` or 0.]\n- `arrive_time` (ISO): [previous `depart_time` + transit + `latency`]\n- `depart_time` (ISO): [`arrive_time` + `hours`]\n- `hours` (float): time spent on the operation. If zero, the event\n is considered to be a waypoint. Defaults are (from highest to lowest priority):\n - `action_time.h['{action}']['{station}']`, \n - `action_time.h['{action}']['default']`,\n - `0.`\n- `comment` (str): comment\n- `speed` (float): speed between previous and given site [`ship_speed.kn_i`] \n\n## Station file\n\n A CSV file whos first line is a header that specifies the field order, using\n the following names:\n - `Name`: station name\n - `Lat`: station latitude\n - `Lon`: station latitude\n - `Type`: used to define default times\n - `Comment`: station comment\n\n\n\n## Miscellaneous features\n\n- Puts name of stations/actions on plot UNLESS they have no \"hours\" (just a\n waypoint) \n \n- Crosses out stations that have already been visited (departure_time entered\n and before UTCDateTime.now() \n \n- Changes the color of the ship's track every time you use the action name \"NEWLEG\"\n \n## Other subdirectories\n\n### `seaplan/_examples/`\n\nExample files and scripts:\n\nUse `reStructuredText\n<http://docutils.sourceforge.net/rst.html>`_ to modify this file.\n",
"bugtrack_url": null,
"license": "",
"summary": "Sea-going mission planning",
"version": "0.5.0",
"project_urls": {
"Homepage": "https://github.com/WayneCrawford/seaplan"
},
"split_keywords": [
"oceanography",
"marine",
"obs"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2bc67d51d7273ecd0b7ce4bf7f5b0987ff76bbe563e450083a224a9a24f7583d",
"md5": "4d5e8648dc804bae44dc4c0482ff7949",
"sha256": "7e62748903b910634c9726f9283cf924879bc0efa85c7d45369fbb766c7dffd3"
},
"downloads": -1,
"filename": "seaplan-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4d5e8648dc804bae44dc4c0482ff7949",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 1711414,
"upload_time": "2024-03-18T15:28:16",
"upload_time_iso_8601": "2024-03-18T15:28:16.717474Z",
"url": "https://files.pythonhosted.org/packages/2b/c6/7d51d7273ecd0b7ce4bf7f5b0987ff76bbe563e450083a224a9a24f7583d/seaplan-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fb3804639902c43ddb54cd8841440a2790ade5fdc82f4940b659d151bdfec313",
"md5": "504da1e1d0ecb27486033128094dc9c0",
"sha256": "b72e437bdd88b859e4e2274c96fc4424be1d7419189f6c7478f2dadbf2815aac"
},
"downloads": -1,
"filename": "seaplan-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "504da1e1d0ecb27486033128094dc9c0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 1017979,
"upload_time": "2024-03-18T15:28:19",
"upload_time_iso_8601": "2024-03-18T15:28:19.548484Z",
"url": "https://files.pythonhosted.org/packages/fb/38/04639902c43ddb54cd8841440a2790ade5fdc82f4940b659d151bdfec313/seaplan-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-18 15:28:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WayneCrawford",
"github_project": "seaplan",
"github_not_found": true,
"lcname": "seaplan"
}
JSON
