Skip to content

Commit

Permalink
Started adding roxygen help
Browse files Browse the repository at this point in the history
  • Loading branch information
iagomosqueira committed Mar 6, 2014
1 parent 9fc4cd9 commit 6129b1f
Show file tree
Hide file tree
Showing 3 changed files with 65 additions and 3 deletions.
4 changes: 4 additions & 0 deletions NEWS
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
FLasher 0.1
===========

* `fwdElement` class as a basic component of `fwdControl`
52 changes: 52 additions & 0 deletions R/classes.R
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,58 @@ setClass('fwdElement',

# fwdControl class {{{

#' A class for the targets and limits of a fishery projection.
#'
#' The desired targets, limits and time steps used in fishery projections can be
#' specified by creating an object of class \code{fwdControl}.
#'
#' [...]
#'
#' @name fwdControl
#' @rdname fwdControl
#' @aliases fwdControl fwdControl-methods fwdControl-class
#' @docType class
#'
#' @section Slots:
#' \describe{
#' \item{target}{The table of values, quantities and time steps used as target (\code{fwdElement}).}
#' }
#'
#' @section Validity: \describe{
#' \item{VALIDITY}{Neque porro quisquam est qui dolorem ipsum.}
#' }
#'
#' @section Accessors:
#' All slots in the class have accessor and replacement methods defined that
#' allow retrieving and substituting individual slots.
#'
#' The values passed for replacement need to be of the class of that slot.
#' A numeric vector can also be used when replacing FLQuant slots, and the
#' vector will be used to substitute the values in the slot, but not its other
#' attributes.
#'
#' @section Constructor:
#'
#' A construction method exists for this class that can take named arguments for
#' any of its slots. All slots are then created to match the requirements of the
#' class validity. If an unnamed \code{FLQuant} object is provided, this is used
#' for sizing but not stored in any slot.
#'
#' @author Iago Mosqueira, Finlay Scott - EC JRC.
#' @seealso \link{fwdElement}
#' @keywords classes
#' @examples
#'
#' # CREATE targets on fishing mortality ('f') by year
#'
#' target <- data.frame(year=2000:2010, value=rlnorm(11), quantity='f')
#'
#' fwc <- fwdControl(target=target)
#'
#' # INSPECT fwdControl object
#'
#' show(fwc)

setClass('fwdControl', representation(
target='fwdElement'),
prototype(target=new('fwdElement')))
Expand Down
12 changes: 9 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,13 @@
# FLasher

New version of Flash
FLasher provides the necessary classes and methods for carrying out
stochastic and deterministic projections of fisheries, both fish stocks
and fish population plus fleets.

## TODO
- PROJECTION

- [ ] ADD roxygen documentation
- CLASSES

- METHODS

- MORE INFO

0 comments on commit 6129b1f

Please sign in to comment.