plotpolys: plotpolys - plots a grid and fills it with relative catches

In haddonm/rforcpue: Functions to Assist With The Analysis of CPUE Data

plotpolys - plots a grid and fills it with relative catches

Description

plotpolys - uses the same input object as plotaus plus the leftlong, rightlong, uplat, and downlat variables to which it adds a grid defined by 'gridon'. It then sums the catches found in each grid and then plots this as a patchwork of colours representing the relative density. Uses the function 'plotpoly'.

Usage

plotpolys(
  intmp,
  leftlong,
  rightlong,
  uplat,
  downlat,
  leg = "topleft",
  mincount = 1,
  intitle = " ",
  gridon = 0.1,
  hot = F,
  map = T,
  scaler = NA,
  textout = TRUE,
  namecatch = "catch_kg"
)

Arguments

intmp	- a matrix or data.frame containing, at least, columns with the names 'Long', 'Lat', and 'catch_kg'.
leftlong	the longitude of the left hand side of the box plotted
rightlong	the longitude of the right hand size of the box plotted
uplat	the latitude (negative) of the top of the box
downlat	nagative latitude of the bottom of the box
leg	- legend location, default is 'topleft', alternatives are 'topright', 'center', 'left', and 'right'
mincount	- the minimum number of observations in a grod cell before it is included in the colour plotting; default - 1.0
intitle	- default="". Provides for a title top center.
gridon	- default 0.1 = 0.1 degree square. could be 0.2, 0.25, 0.5, etc
hot	- default FALSE. If true then instead of 8 levels of catch intensity there are only 4 and these differ each by an order of magnitude.
map	- default TRUE, use FALSE is only the tabulation of catch data into grid cells is required without a plot.
scaler	- default to NA, otherwise used to select which scale to use valid values are 1 - 9. This is used to set the same scale in each of multiple plots.
textout	default = TRUE; determines whether the summary information from the tabulation is pronted to screen or not
namecatch	the name of the variable which to sum into each polygon. this defaults to 'catch_kg', but could be 'Effort', etc.

Value

invisibly returns a matrix of grids with the total catch in each cell in units of tonnes. Also, if map = TRUE, adds the grid and a colour rendition to the map.

Examples

## Not run: 
plotaus()

## End(Not run)

haddonm/rforcpue documentation built on Oct. 12, 2024, 11:55 p.m.