nmplot.n {NMTox}R Documentation

Create plots of the dose and the response for every unique value of a certain variable

Description

This function generates scatter plots of the dose and the response for every unique value of a specified variable

Usage

nmplot.n(data.nm, data.control, id, nano, response, dose, end,
  end.cat, unit, unit.cat, cat, type=c("dose","log"),
  control.opt=c("same","all"), nrow=1, ncol=1)

Arguments

data.nm

Data containing the result of toxicity study

data.control

Data of control values

id

Identifier of the experiment

nano

Name of the nanomaterial

response

Response (endpoint value)

dose

Dose or concentration

end

Toxicity endpoint

end.cat

Specific toxicity endpoint of interest

unit

Unit of measurement of the dose

unit.cat

Specific unit of measurement of the dose

cat

Plot is generated for every unique value of cat

type

Type of the dose to be plotted ("dose" for dose and "log" for log(dose))

control.opt

Option for the control doses. If only control doses with the same unit of measurement as the non-control ones are included, then specify "same" in the control.opt. If all control doses with any units of measurement are included, then specify "all".

nrow

Number of rows in the plotting space (default is 1)

ncol

Number of columns in the plotting space (default is 1)

Details

Value

This function produces scatter plots of the dose and the response for every unique value of a specified variable

Examples

# Create a dataset containing controls (which are named differently)
# from geninvitro dataset:
controldata<-SubsetData(data=geninvitro, x="name", x.cat=c("control", "Control",
             "medium", "medium + BSA", "untreated"))

# Exclude controls (which are named differently) from geninvitro dataset:
invitrodata<-SubsetData(data=geninvitro, x="name", x.cat=c("control", "Control",
             "medium", "medium + BSA", "untreated"), include=FALSE)

# Generate dose-response plots for geninvitro, with DNA STRAND BREAKS as
# the endpoint, concentrations measured in "ug/cm2" and control doses
# measured in any units of measurement (plot is generated for each study
# provider):
#
nmplot.n(data.nm=invitrodata, data.control=controldata, id="experimentID",
         nano="name", response="value", dose="concentration", end="endpoint",
         end.cat="DNA STRAND BREAKS", unit="concentration_unit",
         unit.cat="ug/cm2", cat="studyprovider", type="dose",
         control.opt ="all", nrow=1, ncol=1)

[Package NMTox version 0.1.0 Index]