Query Chemical Identifier Resolver
A interface to the Chemical Identifier Resolver (CIR). (https://cactus.nci.nih.gov/chemical/structure_documentation).
cir_query(
identifier,
representation = "smiles",
resolver = NULL,
match = c("all", "first", "ask", "na"),
verbose = TRUE,
choices = NULL,
...
)identifier |
character; chemical identifier. |
representation |
character; what representation of the identifier should be returned. See details for possible representations. |
resolver |
character; what resolver should be used? If NULL (default) the identifier type is detected and the different resolvers are used in turn. See details for possible resolvers. |
match |
character; How should multiple hits be handled? |
verbose |
logical; should a verbose output be printed on the console? |
choices |
deprecated. Use the |
... |
currently not used. |
CIR can resolve can be of the following identifier: Chemical Names,
IUPAC names,
CAS Numbers, SMILES strings, IUPAC InChI/InChIKeys, NCI/CADD Identifiers,
CACTVS HASHISY, NSC number, PubChem SID, ZINC Code, ChemSpider ID,
ChemNavigator SID, eMolecule VID.
cir_query() can handle only a part of all possible conversions of CIR.
Possible representations are:
'smiles'(SMILES strings),
'names' (Names),
'cas' (CAS numbers),
'stdinchikey' (Standard InChIKey),
'stdinchi' (Standard InChI),
'ficts' (FICTS Identifier),
'ficus' (FICuS Indetifier),
'uuuuu' (uuuuu Identifier),
'mw' (Molecular weight),
'monoisotopic_mass' (Monoisotopic Mass),
'formula' (Chemical Formula),
'chemspider_id' (ChemSpider ID),
'pubchem_sid' (PubChem SID),
'chemnavigator_sid' (ChemNavigator SID),
'h_bond_donor_count' (Number of Hydrogen Bond Donors),
'h_bond_acceptor_count' (Number of Hydrogen Bond Acceptors),
'h_bond_center_count' (Number of Hydrogen Bond Centers),
'rule_of_5_violation_count' (Number of Rule of 5 Violations),
'rotor_count' (Number of Freely Rotatable Bonds),
'effective_rotor_count' (Number of Effectively Rotatable Bonds),
'ring_count' (Number of Rings),
'ringsys_count' (Number of Ring Systems),
'xlogp2' (octanol-water partition coefficient),
'aromatic' (is the compound aromatic),
'macrocyclic' (is the compound macrocyclic),
'heteroatom_count' (heteroatom count),
'hydrogen_atom_count' (H atom count),
'heavy_atom_count' ( Heavy atom count),
'deprotonable_group_count' (Number of deprotonable groups),
'protonable_group_count' (Number of protonable groups).
CIR first tries to determine the identifier type submitted and then
uses 'resolvers' to look up the data.
If no resolver is supplied, CIR tries different resolvers in
turn till a hit is found.
E.g. for names CIR tries first to look up in OPSIN and if this fails
the local name index of CIR.
However, it can be also specified which resolvers to use
(if you know e.g. know your identifier type)
Possible resolvers are:
'name_by_cir' (Lookup in name index of CIR),
'name_by_opsin' (Lookup in OPSIN),
'name_by_chemspider' (Lookup in ChemSpider,
https://cactus.nci.nih.gov/blog/?p=1386),
'smiles' (Lookup SMILES),
'stdinchikey', 'stdinchi' (InChI),
'cas_number' (CAS Number),
'name_pattern' (Google-like pattern search
(https://cactus.nci.nih.gov/blog/?p=1456)
Note, that the pattern search can be combined with other resolvers,
e.g. resolver = 'name_by_chemspider,name_pattern'.
A list of character vectors.
You can only make 1 request per second (this is a hard-coded feature).
cir relies on the great CIR web service created by the CADD
Group at NCI/NIH!
https://cactus.nci.nih.gov/chemical/structure_documentation,
https://cactus.nci.nih.gov/blog/?cat=10,
https://cactus.nci.nih.gov/blog/?p=1386,
https://cactus.nci.nih.gov/blog/?p=1456,
# might fail if API is not available
cir_query("Triclosan", "cas")
cir_query("3380-34-5", "cas", match = "first")
cir_query("3380-34-5", "cas", resolver = "cas_number")
cir_query("3380-34-5", "smiles")
cir_query("Triclosan", "mw")
# multiple inputs
comp <- c("Triclosan", "Aspirin")
cir_query(comp, "cas", match = "first")Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.