BuildModule: BuildModule

Description Usage Arguments Value

Description

Turn a function in the namespace into a module. Will later add functions to upload module to figshare etc. And add testing that the module name is unique.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
BuildModule(
  object,
  type,
  dir = ".",
  title = "",
  description = "",
  details = "",
  author = "",
  email = "",
  version = 0.1,
  paras = NULL,
  dataType = NULL,
  check = TRUE
)

Arguments

object

A function that will be made into a module file. It is good practice to ensure your function does not have the same name as a base function, another module, or other common functions.

type

A string that defines the type of module. Possible module types are occurrence, covariate, process, model, and output.

dir

The directory to put the module into (defaults to the working directory).

title

A short description of the module.

description

(required) A single string giving a full description of the module.

details

(optional) A single string giving details of the module.

author

(required) String giving the author(s) name(s)

email

(required) String giving the correspondence address for the module (only give one address).

version

(optional) Numeric giving the version number. Default 0.1.

paras

A list of the form list(parameterName = 'Parameter description.', anotherParameter = 'Another description.') This is required if the module takes non-default arguments

dataType

Character vector required for all module types except 'covariate'. Indicates the types of data that this module works with. Values can be any of 'presence-only', 'presence/absence', 'presence/background', 'abundance' or 'proportion'. For a occurrence model this should indicate the type of data that is returned and for other modules should indicate the type of data they will work with. If the module works with multiple types they can be supplied in a vector, e.g. c('presence-only', 'presence/absence')

check

Logical indicating if the module should be run through checks once it has been built. Defaults to TRUE.

Value

Name of the module. As a side effect outputs a .R file to the directory specified.


zoon documentation built on Feb. 28, 2020, 5:09 p.m.