Plot a survey plan.

PlotSurveyPlan(
  SurveyPlan,
  UseDefaultTrackSettings = TRUE,
  TrackColor = character(),
  TrackLineWidth = numeric(),
  TrackPointColor = character(),
  TrackPointSize = numeric(),
  TrackPointShape = numeric(),
  ShowStratumPolygon = FALSE,
  StratumPolygon,
  UseDefaultStratumPolygonSettings = TRUE,
  StratumPolygonColor = character(),
  StratumPolygonBorderColor = character(),
  StratumPolygonBorderLineWidth = numeric(),
  ShowMap = TRUE,
  UseDefaultMapSettings = TRUE,
  LandColor = character(),
  BorderColor = character(),
  OceanColor = character(),
  GridColor = character(),
  UseDefaultAspectSettings = TRUE,
  Zoom = numeric(),
  LongitudeMin = numeric(),
  LongitudeMax = numeric(),
  LatitudeMin = numeric(),
  LatitudeMax = numeric(),
  LongitudeCenter = numeric(),
  LatitudeCenter = numeric(),
  UseDefaultLabelSettings = TRUE,
  Title = character(),
  AxisTitleSize = numeric(),
  AxisTickSize = numeric(),
  LegendTitleSize = numeric(),
  LegendTextSize = numeric(),
  UseDefaultFileSettings = TRUE,
  Format = character(),
  Width = numeric(),
  Height = numeric(),
  DotsPerInch = numeric()
)

Arguments

SurveyPlan

The SurveyPlan process data.

UseDefaultTrackSettings

Logical: If TRUE (default) use the default point size settings of the plotting function. Setting this to FALSE will show all point size options of the plotting function in the StoX GUI.

TrackColor

Character: The color to use for the vessel track, defaulted to "black".

TrackLineWidth

Numeric: The width of the track, defaulted to 1.

TrackPointColor

Character: The colors to use when plotting the data points. The colors scale can be given either as vector of colors comprising equally spaced colors of the color scale, or as the name of a color scale function with the first argument being the number of colors. The default is the combined.color. Other options for color scale function are "rainbow", "hcl.colors", "heat.colors", "terrain.colors", "topo.colors" or "cm.colors".

TrackPointSize

Numeric: The size of the points.

TrackPointShape

The shape of the points, as defined for the argument pch in points.

ShowStratumPolygon

Logical: If TRUE include the stratumPolygon. in the plot.

StratumPolygon

The StratumPolygon process data.

UseDefaultStratumPolygonSettings

Logical: If TRUE (default) use the default settings for plotting the StratumPolygon. Setting this to FALSE will show all Stratum plotting options of the plotting function in the StoX GUI.

StratumPolygonColor

Character: The color palette to use for the strata. The default ("hue") is the default HUE color used by ggplot2. See the Palettes section in scale_fill_brewer for a list of options (both Diverging, Qualitative and Sequential color palettes are possible).

StratumPolygonBorderColor

Character: The single color to use for the polygon borders.

StratumPolygonBorderLineWidth

Numeric: The line width of the polygon borders.

ShowMap

Logical: If TRUE include the map in the plot.

UseDefaultMapSettings

Logical: If TRUE (default) use the default settings of the map, specifically LandColor, BorderColor, OceanColor and GridColor. Setting this to FALSE will show all map options of the plotting function in the StoX GUI.

LandColor

Character: The color to use for the land, defaulted to the color used for land in the StoX GUI map (yellow color, rgb(253, 254, 204, maxColorValue = 255)).

BorderColor

Character: The color to use for the borders on land, defaulted to "grey50".

OceanColor

Character: The color to use for the (ocean) background, defaulted to "white", as in the StoX GUI map.

GridColor

Character: The color to use for the longitude/latitude grid lines, defaulted to the color used for the longitude/latitude grid in the StoX GUI map (blue color, rgb(223, 242, 255, maxColorValue = 255).

UseDefaultAspectSettings

Logical: If TRUE (default) use the default aspect settings of the plot, specifically Zoom, LongitudeMin, LongitudeMax, LatitudeMin, LatitudeMax, LongitudeCenter and LatitudeCenter. Setting this to FALSE will show all aspect options of the plotting function in the StoX GUI.

Zoom

Numeric: The zoom of the plot, defaulted to 1, which uses the range of the data as the plot limits. Higher values zooms out and lower values zooms in.

LongitudeMin

Numeric: The minimum longitude limit of the plot, overriding the value derived from Zoom.

LongitudeMax

Numeric: The maximum longitude limit of the plot, overriding the value derived from Zoom.

LatitudeMin

Numeric: The minimum latitude limit of the plot, overriding the value derived from Zoom.

LatitudeMax

Numeric: The maximum latitude limit of the plot, overriding the value derived from Zoom.

LongitudeCenter

Numeric: The longitude of the point around which the plot is zoomed usinng Zoom.

LatitudeCenter

Numeric: The latitude of the point around which the plot is zoomed usinng Zoom.

UseDefaultLabelSettings

Logical: If TRUE (default) use the default text settings of the plot, specifically Title, AxisTitleSize, AxisTickSize, LegendTitleSize and LegendTextSize. Setting this to FALSE will show all text options of the plotting function in the StoX GUI.

Title

Character: The title of the plot, defaulted to no title.

AxisTitleSize

Numeric: The size of the axis titles, defaulted to 20.

AxisTickSize

Numeric: The size of the axis tick marks, defaulted to 20.

LegendTitleSize

Numeric: The size of the legend title, defaulted to 20.

LegendTextSize

Numeric: The size of the legend text, defaulted to 20.

UseDefaultFileSettings

Logical: If TRUE (default) use the default file settings of the output file of the plot, specifically Format, Width, Height and DotsPerInch. Setting this to FALSE will show all file options of the plotting function in the StoX GUI.

Format

Character: The format of the output file from plotting functions, defaulted to "png". Other options are defined by ggsave, including "tiff", "jpeg" and "pdf".

Width

Numeric: The width of the plot in centimeters, defaulted to 17, as per the instructions to authors for submission to the ICES Journal og Marine Science.

Height

Numeric: The height of the plot in centimeters, defaulted to 17.

DotsPerInch

Numeric: The number of dots per inch (DPI), defaulted to 1200.

Value

An object of StoX data type WriteSurveyPlanData.

Examples


stratumFile <- system.file(
  "testresources", 
  "strata_sandeel_2020_firstCoverage.wkt", package = "RstoxBase"
 )
stratumPolygon<- DefineStratumPolygon(
  DefinitionMethod = "ResourceFile", 
  FileName = stratumFile
)

# Harbitz zigzag survey design along each stratum:
surveyPlanZZ_Along <- DefineSurveyPlan(
  DefinitionMethod = "ZigZagRectangularEnclosure", 
  StratumPolygon = stratumPolygon, 
  SurveyTime = 200, 
  SurveySpeed = 10, 
  Seed = 1, 
  Bearing = "Along"
)
#> StoX: SurveyPlan for Stratum AlbjoernLing...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum Engelsk_Klondyke_2020...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum Inner_Shoal_East_2016...
#> StoX: SurveyPlan for Stratum Inner_Shoal_North_2020...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum Inner_Shoal_West_2018...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum Nordgyden...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum Ostbanken_2020...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum Outer_Shoal_2020_1...
#> StoX: SurveyPlan for Stratum Vestbanken_North_2020...
#> StoX: numIter: 1
#> StoX: numIter: 2
#> StoX: SurveyPlan for Stratum VestbankenSouthEast...
#> StoX: SurveyPlan for Stratum VestbankenSouthWest...
#> StoX: SurveyPlan for Stratum Vikingbanken...
#> StoX: numIter: 1
#> StoX: numIter: 2

WriteSurveyPlan(surveyPlanZZ_Along)
#> Simple feature collection with 354 features and 4 fields
#> Geometry type: POINT
#> Dimension:     XY
#> Bounding box:  xmin: 2.491242 ymin: 56.5783 xmax: 6.632381 ymax: 60.66388
#> CRS:           NA
#> First 10 features:
#>                     geometry   track_name track_fid track_seg_id
#> 1  POINT (2.770825 58.16913) AlbjoernLing         0            0
#> 2   POINT (2.550207 58.0863) AlbjoernLing         0            0
#> 3  POINT (2.540432 58.06167) AlbjoernLing         0            1
#> 4   POINT (2.82823 58.11042) AlbjoernLing         0            1
#> 5  POINT (2.829138 58.10948) AlbjoernLing         0            2
#> 6  POINT (2.512165 57.99025) AlbjoernLing         0            2
#> 7  POINT (2.510766 57.98671) AlbjoernLing         0            3
#> 8  POINT (2.886115 58.05037) AlbjoernLing         0            3
#> 9  POINT (2.886817 58.04964) AlbjoernLing         0            4
#> 10  POINT (2.55821 57.92602) AlbjoernLing         0            4
#>    track_seg_point_id
#> 1                   0
#> 2                   1
#> 3                   0
#> 4                   1
#> 5                   0
#> 6                   1
#> 7                   0
#> 8                   1
#> 9                   0
#> 10                  1