find_product_name: Find pesticide product names and registration numbers from...

In leighseverson/purexposure: Pull and Calculate Exposure to CA Pesticide Use Registry Records

Description

For a vector of years and product search terms, find_product_name returns a data frame with corresponding product registration numbers, prodno, indicator codes, and product names.

Usage

find_product_name(years, products = "all", quiet = FALSE, by_year = FALSE, ...)

Arguments

years	A vector of four digit years in the range of 1990 to 2017.
products	A character string or a vector of character strings with pesticide product names that you would like to search for. Not case sensitive. The default is "all", which will return all pesticide products applied for a given year.
quiet	TRUE / FALSE indicating whether you would like a message and progress bar printed for the product table that is downloaded. The default value is FALSE.
by_year	TRUE / FALSE for whether you would like PUR Product Lookup Tables separated by year (in a 'year' column). If 'by_year' is 'FALSE', the default, a data frame is returned with unique results from all years given in the 'years' argument.
...	Used internally.

Details

Product tables are pulled by year from the CDPR's FTP server. Downloaded tables are saved in a temporary environment, which is deleted at the end of the current R session.

Value

A data frame with seven columns:

prodno

The CA registration number. Can be matched with the prodno in a raw or cleaned PUR data set.

prodstat_ind

Character. An indication of product registration status:

• A = Active

• B = Inactive

• C = Inactive, Not Renewed

• D = Inactive, Voluntary Cancellation

• E = Inactive, Cancellation

• F = Inactive, Suspended

• G = Inactive, Invalid Data

• H = Active, Suspended

product_name

Character. The name of the product taken from the registered product label. May have been modified by DPR's Registration Branch to ensure uniqueness.

signlwrd_ind

Integer. The signal word printed on the front of the product label:

• 1 = Danger (Poison)

• 2 = Danger (Only)

• 3 = Warning

• 4 = Caution

• 5 = None

product

Product name search terms.

year

The year for which product table information was pulled. Included if 'by_year' is set to TRUE.

Examples

prod_df <- find_product_name(2000, "mosquito")
prod_df2 <- find_product_name(2010, c("insecticide", "rodenticide"))

leighseverson/purexposure documentation built on Aug. 13, 2021, 6:34 p.m.