reflora_records

Documentation for reflora_records() from the refloraR package.

refloraR::reflora_records()

Description {

Retrieve occurrence records for specific taxa from the

\href

{ https://ipt.jbrj.gov.br/reflora/ }

{ REFLORA Virtual Herbarium } ,

hosted bythe \href

{ https://www.gov.br/jbrj/pt-br }

{ Rio de Janeiro Botanical Garden } .

This function handles automatic download, parsing, filtering, and optional

saving of the occurrence data.

}

Details {

This function processes Darwin Core Archive (DwC-A) files from REFLORA. You

may supply a specific path to previously downloaded files using path, or let

the function handle the download automatically. Filters can be applied by taxon

name, herbarium code, state, and year. The reorder argument allows you to

customize the structure of the returned data. Use verbose = TRUE to see

status updates. Use save = TRUE to save results to disk as a CSV file in the

specified directory.

}

Arguments

Argument	Description
uppercase letters or leave it as
uppercase letters or leave it as
multiple scientific names at family, genus or species level. }
multiple scientific names at family, genus or species level. }

dwca folders are. If you do not provide a path, the function will download the most updated version of the REFLORA dwca files. } | { path } { Optional; a pathway to the computer’s directory, where the REFLORA-downloaded dwca folders are. If you do not provide a path, the function will download the most updated version of the REFLORA dwca files. } | | { updates } { Logical, if | { updates } { Logical, if | | { verbose } { Logical, if | { verbose } { Logical, if | | { save } { Logical, if | { save } { Logical, if | | { dir } { Pathway to the computer’s directory, where the table-formatted summary will be saved. The default is to create a directory named | { dir } { Pathway to the computer’s directory, where the table-formatted summary will be saved. The default is to create a directory named | | { filename } { Name of the output file to be saved. The default is to create a file entitled |

{ filename } { Name of the output file to be saved. The default is to create a file entitled |

Value {

A data.frame containing occurrence records for the selected taxon

and criteria from the chosen REFLORA herbaria. If save = TRUE, the function

will write the results to a CSV file inside the dir directory, and also

generate or append a log.txt file that summarizes the download session

including total records and breakdowns by herbarium, family, genus, country,

and state.

}

Examples

 \examples
{


\dontrun
{




fam_taxa <- c("Fabaceae", "Ochnaceae")

reflora_records(herbarium = c("ALCB", "HUEFS", "K", "RB"),

                taxon = fam_taxa,

                verbose = TRUE,

                save = TRUE,

                dir = "reflora_records",

                filename = "reflora_records_search")

}




}