Pen Bay Marine Data documentation¶
Add your content using reStructuredText syntax. See the
reStructuredText
documentation for details.
penbay¶
Command Line Interface for weather and buoy data.
penbay [OPTIONS] COMMAND [ARGS]...
buoys¶
Command line interface for working with buoy data and firmware.
penbay buoys [OPTIONS] COMMAND [ARGS]...
db¶
Commands that interact with the buoy database.
penbay buoys db [OPTIONS] COMMAND [ARGS]...
describe¶
penbay buoys db describe [OPTIONS] {wynken|blynken} {diagnostic|sonde}
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --measurement <measurement>¶
The InfluxDB measurement (table) name.
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
Arguments
- NAME¶
Required argument
- TABLE¶
Required argument
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUXDB_MEASUREMENT
Provide a default for
--measurement
- INFLUX_API_TOKEN
Provide a default for
--token
upload¶
Upload buoy data to the database.
penbay buoys db upload [OPTIONS] {wynken|blynken} {diagnostic|sonde}
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
Arguments
- NAME¶
Required argument
- TABLE¶
Required argument
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUX_API_TOKEN
Provide a default for
--token
file¶
Commands that interact with the buoy data file system.
penbay buoys file [OPTIONS] COMMAND [ARGS]...
describe¶
Summarize available data for a station.
penbay buoys file describe [OPTIONS] {wynken|blynken} {diagnostic|sonde}
Arguments
- NAME¶
Required argument
- TABLE¶
Required argument
export¶
Export buoy data to a different format.
penbay buoys file export [OPTIONS] {wynken|blynken} {diagnostic|sonde}
Arguments
- NAME¶
Required argument
- TABLE¶
Required argument
gpx¶
Export buoy data to a different format.
penbay buoys file gpx [OPTIONS] {wynken|blynken}
Arguments
- NAME¶
Required argument
list¶
List available stations from static data.
penbay buoys file list [OPTIONS]
firmware¶
Command line interface for working with buoy data and firmware.
penbay buoys firmware [OPTIONS] COMMAND [ARGS]...
lib¶
Fill in firmware template with options passed on the command line.
penbay buoys firmware lib [OPTIONS]
Options
- --file <file>¶
Template file
template¶
Fill in firmware template with options passed on the command line.
penbay buoys firmware template [OPTIONS] {wynken|blynken}
Options
- --address <address>¶
Required Pakbus address
- --client <client>¶
Required Client ID
- --file <file>¶
Template file
- --latitude <latitude>¶
Required Latitude
- --longitude <longitude>¶
Required Longitude
Arguments
- NAME¶
Required argument
plot¶
Commands that generate plots using buoy data.
penbay buoys plot [OPTIONS] COMMAND [ARGS]...
daily¶
Plot a single DataStream aggregated by day.
penbay buoys plot daily [OPTIONS] {wynken|blynken} {diagnostic|sonde} {sea_wat
er_temperature|mass_concentration_of_oxygen_in_sea_wat
er|sea_water_salinity}
Options
- --image-format <image_format>¶
The output format.
- Options:
ImageFormat.PNG
Arguments
- NAME¶
Required argument
- TABLE¶
Required argument
- SERIES¶
Required argument
tail¶
Plot the most recent data from a buoy for a single data stream.
penbay buoys plot tail [OPTIONS] {wynken|blynken} {diagnostic|sonde} {sea_wate
r_temperature|mass_concentration_of_oxygen_in_sea_water
|sea_water_salinity}
Options
- --image-format <image_format>¶
The output format.
- Options:
ImageFormat.PNG
Arguments
- NAME¶
Required argument
- TABLE¶
Required argument
- SERIES¶
Required argument
weather¶
Weather station commands.
penbay weather [OPTIONS] COMMAND [ARGS]...
db¶
Commands that interact with the weather database.
penbay weather db [OPTIONS] COMMAND [ARGS]...
backfill¶
Backfill missing data from local to database.
penbay weather db backfill [OPTIONS] {apprenticeshop|dev}
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --measurement <measurement>¶
The InfluxDB measurement (table) name.
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
Arguments
- STATION¶
Required argument
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUXDB_MEASUREMENT
Provide a default for
--measurement
- INFLUX_API_TOKEN
Provide a default for
--token
describe¶
Show information about the data already stored in Influx database.
penbay weather db describe [OPTIONS]
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --measurement <measurement>¶
The InfluxDB measurement (table) name.
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUXDB_MEASUREMENT
Provide a default for
--measurement
- INFLUX_API_TOKEN
Provide a default for
--token
describe¶
Compare local and database data before merging or backfilling.
penbay weather describe [OPTIONS] {apprenticeshop|dev} {air_temperature|relati
ve_humidity|wind_speed|wind_from_direction|air_pressur
e|wind_speed_of_gust|wind_gust_from_direction|wind_chi
ll_of_air_temperature|solar_irradiance|ultraviolet_ind
ex|rainfall_amount|rainfall_rate|heat_index_of_air_tem
perature|dew_point_temperature|water_evapotranspiratio
n_flux}
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --measurement <measurement>¶
The InfluxDB measurement (table) name.
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
Arguments
- STATION¶
Required argument
- SERIES¶
Required argument
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUXDB_MEASUREMENT
Provide a default for
--measurement
- INFLUX_API_TOKEN
Provide a default for
--token
file¶
Commands that interact with the weather file system.
penbay weather file [OPTIONS] COMMAND [ARGS]...
describe¶
Parse and normalize weather station data for display
penbay weather file describe [OPTIONS] {apprenticeshop|dev}
Arguments
- STATION¶
Required argument
export¶
Export normalized weather station data to CSV.
penbay weather file export [OPTIONS] {apprenticeshop|dev}
Arguments
- STATION¶
Required argument
plot¶
Commands that generate plots using weather data.
penbay weather plot [OPTIONS] COMMAND [ARGS]...
daily¶
Display a single DataStream aggregated by day.
penbay weather plot daily [OPTIONS] {apprenticeshop|dev} {air_temperature|rela
tive_humidity|wind_speed|wind_from_direction|air_pre
ssure|wind_speed_of_gust|wind_gust_from_direction|wi
nd_chill_of_air_temperature|solar_irradiance|ultravi
olet_index|rainfall_amount|rainfall_rate|heat_index_
of_air_temperature|dew_point_temperature|water_evapo
transpiration_flux}
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --measurement <measurement>¶
The InfluxDB measurement (table) name.
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
- --image-format <image_format>¶
The output format.
- Options:
ImageFormat.PNG
Arguments
- STATION¶
Required argument
- SERIES¶
Required argument
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUXDB_MEASUREMENT
Provide a default for
--measurement
- INFLUX_API_TOKEN
Provide a default for
--token
tail¶
Plot a comparison of local and InfluxDB data for a specific series.
Keyword arguments are passed through to the rendering function
penbay weather plot tail [OPTIONS] {apprenticeshop|dev} {air_temperature|relat
ive_humidity|wind_speed|wind_from_direction|air_press
ure|wind_speed_of_gust|wind_gust_from_direction|wind_
chill_of_air_temperature|solar_irradiance|ultraviolet
_index|rainfall_amount|rainfall_rate|heat_index_of_ai
r_temperature|dew_point_temperature|water_evapotransp
iration_flux}
Options
- --host <host>¶
The InfluxDB server URL. Defaults to environment variable INFLUX_SERVER_URL
- --measurement <measurement>¶
The InfluxDB measurement (table) name.
- --token <token>¶
The InfluxDB API token. Defaults to environment variable INFLUX_API_TOKEN
- --image-format <image_format>¶
The output format.
- Options:
ImageFormat.PNG
- --days <days>¶
The time range to include in the plot (e.g., 7, 14).
- --resample <resample>¶
How to resample the data (e.g., 1d, 1h).
- --qartod <qartod>¶
Path to the QARTOD configuration file.
Arguments
- STATION¶
Required argument
- SERIES¶
Required argument
Environment variables
- INFLUX_SERVER_URL
Provide a default for
--host
- INFLUXDB_MEASUREMENT
Provide a default for
--measurement
- INFLUX_API_TOKEN
Provide a default for
--token