Evidence is organised interaction -> experiment -> observation: one actor
(an organism or a protein) tested on one plastic in one paper, the
experiments that tested it, and the values each measured. Interactions are
listed per protein; evidence_interactions(level = "observation") gives
one row per measured value. The material tables describe what was assayed:
constructs (sequences as expressed), preparations (host, purification,
tags) and binding (adsorption) assays.
Usage
evidence_interactions(
protein,
evidence_level = c("all", "direct", "indirect"),
level = c("interaction", "experiment", "observation"),
include_sequenceless = FALSE,
limit = Inf,
kind = NULL,
client = plasticdb_client()
)
evidence_kinetics(protein, limit = Inf, client = plasticdb_client())
evidence_properties(protein, limit = Inf, client = plasticdb_client())
evidence_binding_assays(..., limit = Inf, client = plasticdb_client())
evidence_binding_assay(assay_id, client = plasticdb_client())
evidence_constructs(..., limit = Inf, client = plasticdb_client())
evidence_construct(construct_id, client = plasticdb_client())
evidence_construct_structures(construct_id, client = plasticdb_client())
evidence_preparations(..., limit = Inf, client = plasticdb_client())
evidence_preparation(preparation_id, client = plasticdb_client())
evidence_experiment_preparations(experiment_id, client = plasticdb_client())
interactions_list(..., limit = Inf, client = plasticdb_client())
interactions_get(interaction_id, client = plasticdb_client())
experiments_list(..., limit = Inf, client = plasticdb_client())
experiments_get(experiment_id, client = plasticdb_client())
observations_list(..., limit = Inf, client = plasticdb_client())
observations_get(observation_id, client = plasticdb_client())Arguments
- protein
A protein accession.
- evidence_level
"all"(the default),"direct"(assayed on the protein itself) or"indirect"(credited through its engineered variants) interactions.- level
One row per
"interaction","experiment"or"observation". Deeper levels repeat the interaction's columns and addexperiment.*(andobservation.*) columns.- include_sequenceless
Include records without a sequence.
- limit
The most records to return (
Inffor all of them).- kind
Deprecated: the old name of
evidence_level. It is sent asevidence_level, never alongside it; different values in both signalplasticdb_argument_error.- client
- ...
Filters (see Details), named as the API names them.
- assay_id, construct_id, preparation_id, experiment_id, interaction_id
A record's id.
- observation_id
A record's id.
Details
evidence_interactions(),evidence_kinetics()andevidence_properties()are the same asproteins_interactions(),proteins_kinetics()andproteins_properties().evidence_binding_assays(),evidence_constructs()andevidence_preparations()list the material tables, filtered byprotein,protein_id,protein_variant_id,paper_idordoi(and, for binding assays,plastic,plastic_idandinclude_subtypes). Constructs carry sequences:as_aastringset()works on them.evidence_binding_assay(),evidence_construct()andevidence_preparation()return one record by id;evidence_construct_structures()the structures linked to a construct andevidence_experiment_preparations()the preparations one experiment assayed.interactions_list(),experiments_list()andobservations_list()list the spine as flat tables of every public record (the columns of the release tables of the same name; an interaction addsactor_typeand the actors' accessions,product_compound_idsis a list column), andinteractions_get(),experiments_get()andobservations_get()return one by id. They need no protein: filter withplastic(andinclude_subtypes),plastic_id,microorganism(the evidence that credits the organism, its enzymes' assays included),protein(an accession),evidence_level("all","direct"or"indirect";"direct"and"indirect"needproteinormicroorganism),paper_id,doi,polarity,evidence_method,substrate_form,measurement_typeandhas_quantitative. Experiments also takeinteraction_id, and observationsinteraction_idandexperiment_id. On interactions the experiment and observation filters ask one of its experiments to match them all. These lists answer a pinned release too. Records are visible exactly as in a release: staged, withdrawn or merged records are never listed.
Examples
obs <- evidence_interactions("PBFCTW", level = "observation", limit = 2)
dim(obs)
# \donttest{
interactions_list(plastic = "PET", evidence_level = "direct",
protein = "PBFCTW", limit = 5)
constructs <- evidence_constructs(protein = "PBFCTW", limit = 2)
as_aastringset(constructs)
# }