tcplLoadClib: Load chemical library information
In daynefiler/tcpl: ToxCast Data Analysis Pipeline

Description Usage Arguments Details Value Examples

tcplLoadClib queries the tcpl databases and returns information about the chemial library.

1	tcplLoadClib(field = NULL, val = NULL)

`field`	Character of length 1, `'chid'` or `'clib'`, whether to search by chemical id (chid), or chemical library (clib)
`val`	The values to query on

Chemicals are stored in different libraries by chemcial ID. Therefore, it is not possible to delineate samples with the same chemical ID into two distinct chemical libraries. However, it is possible for a chemcial ID to belong to more than one (or no) chemical libraries.

When chemicals belong to more than one library, the chemical is listed multiple times (one for each distinct library).

A data.table with the chemical library information for the given parameters.

## Store the current config settings, so they can be reloaded at the end 
## of the examples
conf_store <- tcplConfList()
tcplConfDefault()

## Passing no parameters gives all of the chemical ISs that have a chemical
## library registered
clib <- tcplLoadClib()

## Notice there are more rows in tcplLoadClib than in tcplLoadChem, 
## indicating some chemicals must belong to more than library.
chem <- tcplLoadChem(include.spid = FALSE)
nrow(chem)
nrow(clib)

## It is possible that some chemicals do not have a chemical library 
## registered, although this is not the case in the example data.
all(chem$chid %in% clib$chid)

## Show the unique chemical libraries
clib[ , unique(clib)]

## Specifying a chemical library will not show what other libraries a 
## chemical might belong to.
tcplLoadClib(field = "clib", val = "other")
tcplLoadClib(field = "chid", val = 1:2)

## Reset configuration
options(conf_store)