plot_volume.MS70: A simple but unelegant way of plotting the sonar volume.

View source: R/plot_volume.MS70.R

plot_volume.MS70R Documentation

A simple but unelegant way of plotting the sonar volume.

Description

A simple but unelegant way of plotting the sonar volume.

Usage

plot_volume.MS70(
  data,
  xyzlim = NULL,
  t = 1,
  plot = c("proj", "frame"),
  cs.pos = "g",
  cs.view = "g",
  length_edges = 200,
  length_bows = 100,
  bowdens = 100,
  beamdens = 1,
  col = c("orange", "cornflowerblue"),
  sides = c("trbl", "trbl"),
  ends = FALSE,
  ...
)

Arguments

data

is a list of data including the elements named "dira", "dire", "asps", "sint", "lenb", "rtzv", "psxv", "psyv", "pszv" and "psze".

xyzlim

is eihter a three column matrix of two rows, where the first column represents the plotting range of x-values and the second and third for the y- and z-values, or NA, indicating that the ranges of the sonar grid are to be returned.

t

is the time step number of which to plot the sonar grid in the case that data$vbsc has a third dimension indicating time. 't' must be given as a single integer in the range seq_along(data$psxv).

plot

is either "proj", for plotting the projection of the sonar volume onto the surface (the old method) or "frame" for plotting the frame around the sonar volume.

cs.pos

is a single character representing the coordinate system used for the plotted data (one of "g" for global or "v" for vessel).

cs.view

is a single character representing the coordinate system used for the view point (one of "g" for global or "v" for vessel).

length_edges

is the number of points along the bows, which if chosen too low can result in lines appearing not to reach the bounding box.

length_bows

is the number of points along the edges, which if chosen too low can result in lines appearing not to reach the bounding box.

bowdens

is the distance in meters between bows. If given as a two element vector, the first is for the bows on the lower end of the sonar volume and the second is for the bows on the horizontal possibly projected end.

col

is a vector of two color elements (string or integers) representing the color for the plotted frame, and the color of the lines forced onto the top of the bounding box respectively (in case parts of the frame is above the bounding box).

sides

is a vector of two strings, one for the lines and one for the bows, including the characters "b" for bottom grid, "l" for left grid (as seed from the sonar), "t" for the top grid and "r" for the left grid.

...

are inputs passed on to lines3d().


arnejohannesholmin/cpplot3d documentation built on April 14, 2024, 11:36 p.m.