From 6937e41d317b953d8246203814500166dbe89470 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Tue, 13 Oct 2020 11:26:03 +0200 Subject: Temporarily remove @example tags Due to r-lib/roxygen2#1158 --- man/chent.Rd | 273 ++++++++++++++++++++++++++++++++++++++++++++++---- man/draw_svg.chent.Rd | 9 +- man/pai.Rd | 87 ++++++++++++++-- man/plot.chent.Rd | 7 -- man/pp.Rd | 65 ++++++++++-- 5 files changed, 398 insertions(+), 43 deletions(-) (limited to 'man') diff --git a/man/chent.Rd b/man/chent.Rd index 29fba70..a1a5fe8 100644 --- a/man/chent.Rd +++ b/man/chent.Rd @@ -1,20 +1,19 @@ % Generated by roxygen2: do not edit by hand % Please edit documentation in R/chent.R -\docType{class} \name{chent} \alias{chent} \title{An R6 class for chemical entities with associated data} -\format{An \code{\link{R6Class}} generator object} -\usage{ -chent +\format{ +An \code{\link{R6Class}} generator object } \description{ The class is initialised with an identifier. Chemical information is retrieved from the internet. Additionally, it can be generated using RDKit if RDKit and its python bindings are installed and configured for use with PythonInR. } -\section{Fields}{ - +\keyword{data} +\section{Public fields}{ +\if{html}{\out{
}} \describe{ \item{\code{identifier}}{The identifier that was used to initiate the object, with attribute 'source'} @@ -50,18 +49,258 @@ configured for use with PythonInR} \item{\code{soil_sorption}}{Dataframe of soil sorption data} \item{\code{PUF}}{Plant uptake factor} -}} +} +\if{html}{\out{
}} +} +\section{Methods}{ +\subsection{Public methods}{ +\itemize{ +\item \href{#method-new}{\code{chent$new()}} +\item \href{#method-try_pubchem}{\code{chent$try_pubchem()}} +\item \href{#method-get_pubchem}{\code{chent$get_pubchem()}} +\item \href{#method-get_rdkit}{\code{chent$get_rdkit()}} +\item \href{#method-get_chyaml}{\code{chent$get_chyaml()}} +\item \href{#method-add_p0}{\code{chent$add_p0()}} +\item \href{#method-add_cwsat}{\code{chent$add_cwsat()}} +\item \href{#method-add_PUF}{\code{chent$add_PUF()}} +\item \href{#method-add_TP}{\code{chent$add_TP()}} +\item \href{#method-add_transformation}{\code{chent$add_transformation()}} +\item \href{#method-add_soil_degradation}{\code{chent$add_soil_degradation()}} +\item \href{#method-add_soil_ff}{\code{chent$add_soil_ff()}} +\item \href{#method-add_soil_sorption}{\code{chent$add_soil_sorption()}} +\item \href{#method-pdf}{\code{chent$pdf()}} +\item \href{#method-png}{\code{chent$png()}} +\item \href{#method-emf}{\code{chent$emf()}} +\item \href{#method-clone}{\code{chent$clone()}} +} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-new}{}}} +\subsection{Method \code{new()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$new( + identifier, + smiles = NULL, + smiles_source = "user", + inchikey = NULL, + inchikey_source = "user", + pubchem = TRUE, + pubchem_from = c("name", "smiles", "inchikey"), + rdkit = TRUE, + template = NULL, + chyaml = TRUE +)}\if{html}{\out{
}} +} -\examples{ -oct <- chent$new("1-octanol", smiles = "CCCCCCCCO") -print(oct) -if (!is.null(oct$Picture)) { - plot(oct) } -caffeine <- chent$new("caffeine") -print(caffeine) -if (!is.null(caffeine$Picture)) { - plot(caffeine) +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-try_pubchem}{}}} +\subsection{Method \code{try_pubchem()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$try_pubchem(query, from = "name")}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-get_pubchem}{}}} +\subsection{Method \code{get_pubchem()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$get_pubchem(pubchem_cid)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-get_rdkit}{}}} +\subsection{Method \code{get_rdkit()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$get_rdkit(template = NULL)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-get_chyaml}{}}} +\subsection{Method \code{get_chyaml()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$get_chyaml( + repo = c("wd", "local", "web"), + chyaml = paste0(URLencode(self$identifier), ".yaml") +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_p0}{}}} +\subsection{Method \code{add_p0()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_p0(p0, T = NA, source = NA, page = NA, remark = "")}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_cwsat}{}}} +\subsection{Method \code{add_cwsat()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_cwsat(cwsat, T = NA, pH = NA, source = NA, page = NA, remark = "")}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_PUF}{}}} +\subsection{Method \code{add_PUF()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_PUF( + PUF = 0, + source = "focus_generic_gw_2014", + page = 41, + remark = "Conservative default value" +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_TP}{}}} +\subsection{Method \code{add_TP()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_TP(x, smiles = NULL, pubchem = FALSE)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_transformation}{}}} +\subsection{Method \code{add_transformation()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_transformation( + study_type, + TP_identifier, + max_occurrence, + remark = "", + source = NA, + pages = NA +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_soil_degradation}{}}} +\subsection{Method \code{add_soil_degradation()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_soil_degradation( + soils, + DT50_mod, + DT50_mod_ref, + type = NA, + country = NA, + pH_orig = NA, + pH_medium = NA, + pH_H2O = NA, + perc_OC = NA, + temperature = NA, + moisture = NA, + category = "lab", + formulation = NA, + model = NA, + chi2 = NA, + remark = "", + source, + page = NA +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_soil_ff}{}}} +\subsection{Method \code{add_soil_ff()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_soil_ff(target, soils, ff = 1, remark = "", source, page = NA)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-add_soil_sorption}{}}} +\subsection{Method \code{add_soil_sorption()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$add_soil_sorption( + soils, + Kf, + Kfoc, + N, + type = NA, + pH_orig = NA, + pH_medium = NA, + pH_H2O = NA, + perc_OC = NA, + perc_clay = NA, + CEC = NA, + remark = "", + source, + page = NA +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-pdf}{}}} +\subsection{Method \code{pdf()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$pdf( + file = paste0(self$identifier, ".pdf"), + dir = "structures/pdf", + template = NULL +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-png}{}}} +\subsection{Method \code{png()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$png( + file = paste0(self$identifier, ".png"), + dir = "structures/png", + antialias = "gray" +)}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-emf}{}}} +\subsection{Method \code{emf()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$emf(file = paste0(self$identifier, ".emf"), dir = "structures/emf")}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clone}{}}} +\subsection{Method \code{clone()}}{ +The objects of this class are cloneable with this method. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{chent$clone(deep = FALSE)}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{deep}}{Whether to make a deep clone.} +} +\if{html}{\out{
}} +} } } -\keyword{data} diff --git a/man/draw_svg.chent.Rd b/man/draw_svg.chent.Rd index 93b657d..2125b47 100644 --- a/man/draw_svg.chent.Rd +++ b/man/draw_svg.chent.Rd @@ -4,8 +4,13 @@ \alias{draw_svg.chent} \title{Draw SVG graph from a chent object using RDKit} \usage{ -draw_svg.chent(x, width = 300, height = 150, - filename = paste0(names(x$identifier), ".svg"), subdir = "svg") +draw_svg.chent( + x, + width = 300, + height = 150, + filename = paste0(names(x$identifier), ".svg"), + subdir = "svg" +) } \arguments{ \item{x}{The chent object to be plotted} diff --git a/man/pai.Rd b/man/pai.Rd index 96f21d0..6a243ab 100644 --- a/man/pai.Rd +++ b/man/pai.Rd @@ -4,24 +4,91 @@ \name{pai} \alias{pai} \title{An R6 class for pesticidal active ingredients and associated data} -\format{An \code{\link{R6Class}} generator object} -\usage{ -pai +\format{ +An \code{\link{R6Class}} generator object } \description{ The class is initialised with an identifier which is generally an ISO common name. Additional chemical information is retrieved from the internet if available. } -\section{Fields}{ - +\keyword{data} +\section{Super class}{ +\code{\link[chents:chent]{chents::chent}} -> \code{pai} +} +\section{Public fields}{ +\if{html}{\out{
}} \describe{ \item{\code{iso}}{ISO common name according to ISO 1750 as retreived from www.alanwood.net/pesticides} \item{\code{alanwood}}{List of information retreived from www.alanwood.net/pesticides} -}} +} +\if{html}{\out{
}} +} +\section{Methods}{ +\subsection{Public methods}{ +\itemize{ +\item \href{#method-new}{\code{pai$new()}} +\item \href{#method-clone}{\code{pai$clone()}} +} +} +\if{html}{ +\out{
Inherited methods} +\itemize{ +\item \out{}\href{../../chents/html/chent.html#method-add_PUF}{\code{chents::chent$add_PUF()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_TP}{\code{chents::chent$add_TP()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_cwsat}{\code{chents::chent$add_cwsat()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_p0}{\code{chents::chent$add_p0()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_soil_degradation}{\code{chents::chent$add_soil_degradation()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_soil_ff}{\code{chents::chent$add_soil_ff()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_soil_sorption}{\code{chents::chent$add_soil_sorption()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-add_transformation}{\code{chents::chent$add_transformation()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-emf}{\code{chents::chent$emf()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-get_chyaml}{\code{chents::chent$get_chyaml()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-get_pubchem}{\code{chents::chent$get_pubchem()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-get_rdkit}{\code{chents::chent$get_rdkit()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-pdf}{\code{chents::chent$pdf()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-png}{\code{chents::chent$png()}}\out{} +\item \out{}\href{../../chents/html/chent.html#method-try_pubchem}{\code{chents::chent$try_pubchem()}}\out{} +} +\out{
} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-new}{}}} +\subsection{Method \code{new()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{pai$new( + iso, + identifier = iso, + smiles = NULL, + smiles_source = "user", + inchikey = NULL, + inchikey_source = "user", + alanwood = TRUE, + pubchem = TRUE, + pubchem_from = "auto", + rdkit = TRUE, + template = NULL, + chyaml = TRUE +)}\if{html}{\out{
}} +} -\examples{ -atr <- pai$new("atrazine") -print(atr) } -\keyword{data} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clone}{}}} +\subsection{Method \code{clone()}}{ +The objects of this class are cloneable with this method. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{pai$clone(deep = FALSE)}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{deep}}{Whether to make a deep clone.} +} +\if{html}{\out{
}} +} +} +} diff --git a/man/plot.chent.Rd b/man/plot.chent.Rd index f2850fa..e5a8770 100644 --- a/man/plot.chent.Rd +++ b/man/plot.chent.Rd @@ -14,10 +14,3 @@ \description{ Plot method for chent objects } -\examples{ -caffeine <- chent$new("caffeine") -print(caffeine) -if (!is.null(caffeine$Picture)) { - plot(caffeine) -} -} diff --git a/man/pp.Rd b/man/pp.Rd index 3957de7..cd950df 100644 --- a/man/pp.Rd +++ b/man/pp.Rd @@ -4,15 +4,15 @@ \name{pp} \alias{pp} \title{R6 class for holding a product with at least one active ingredient} -\format{An \code{\link{R6Class}} generator object.} -\usage{ -pp +\format{ +An \code{\link{R6Class}} generator object. } \description{ An R6 class for holding information about a product with at least one active ingredient } -\section{Fields}{ - +\keyword{data} +\section{Public fields}{ +\if{html}{\out{
}} \describe{ \item{\code{name}}{The name of the product} @@ -21,6 +21,57 @@ An R6 class for holding information about a product with at least one active ing \item{\code{concentrations}}{The concentration of the ais} \item{\code{concentration_units}}{Defaults to g/L} -}} +} +\if{html}{\out{
}} +} +\section{Methods}{ +\subsection{Public methods}{ +\itemize{ +\item \href{#method-new}{\code{pp$new()}} +\item \href{#method-print}{\code{pp$print()}} +\item \href{#method-clone}{\code{pp$clone()}} +} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-new}{}}} +\subsection{Method \code{new()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{pp$new( + name, + ..., + concentrations, + concentration_units = "g/L", + density = 1000, + density_units = "g/L" +)}\if{html}{\out{
}} +} -\keyword{data} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-print}{}}} +\subsection{Method \code{print()}}{ +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{pp$print()}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clone}{}}} +\subsection{Method \code{clone()}}{ +The objects of this class are cloneable with this method. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{pp$clone(deep = FALSE)}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{deep}}{Whether to make a deep clone.} +} +\if{html}{\out{
}} +} +} +} -- cgit v1.2.1