Interactive plotly plot of environmental variables and species occurrence data. WARNING: This function is under development and its functionality is limited Makes a search using occurrencesand plots environmental variables associated with species presence against each other. Alternatively, makes a search using occurrencesand plots species occurrence data e.g frequencies against environmental variables. Note that there is a limit of 500000 records per request when using method="indexed". Use the method="offline" for larger requests. For small requests, method="indexed" likely to be faster.

scatterplot(taxon, ...)

Arguments

taxon

string: (optional) query of the form field:value (e.g. "genus:Macropus") or a free text search (e.g. "macropodidae"). Note that a free-text search is equivalent to specifying the "text" field (i.e. taxon="Alaba" is equivalent to taxon="text:Alaba". The text field is populated with the taxon name along with a handful of other commonly-used fields, and so just specifying your target taxon (e.g. taxon="Alaba vibex") will probably work. However, for reliable results it is recommended to use a specific field where possible (see nbn_fields("occurrence_indexed") for valid fields). It is also good practice to quote the taxon name if it contains multiple words, for example taxon="taxon_name:\"Alaba vibex\""

...

: other options passed to occurrences()

Value

Data frame of occurrence results, with one row per occurrence record. The columns of the dataframe will depend on the requested fields. The data frame is plotted with ggplot and output stored as pdf, an interactive ggplot using plotly is displayed on-screen.

References

See also

sbdi_reasons for download reasons; sbdi_config

Examples

if (FALSE) { scatterplot(taxon="Ectocarpus siliculosus", download_reason_id=10) }