Skip to contents

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 add experiment.* (and observation.*) columns.

include_sequenceless

Include records without a sequence.

limit

The most records to return (Inf for all of them).

kind

Deprecated: the old name of evidence_level. It is sent as evidence_level, never alongside it; different values in both signal plasticdb_argument_error.

client

A plasticdb_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.

Value

A tibble with provenance, or a plasticdb_record list.

Details

  • evidence_interactions(), evidence_kinetics() and evidence_properties() are the same as proteins_interactions(), proteins_kinetics() and proteins_properties().

  • evidence_binding_assays(), evidence_constructs() and evidence_preparations() list the material tables, filtered by protein, protein_id, protein_variant_id, paper_id or doi (and, for binding assays, plastic, plastic_id and include_subtypes). Constructs carry sequences: as_aastringset() works on them.

  • evidence_binding_assay(), evidence_construct() and evidence_preparation() return one record by id; evidence_construct_structures() the structures linked to a construct and evidence_experiment_preparations() the preparations one experiment assayed.

  • interactions_list(), experiments_list() and observations_list() list the spine as flat tables of every public record (the columns of the release tables of the same name; an interaction adds actor_type and the actors' accessions, product_compound_ids is a list column), and interactions_get(), experiments_get() and observations_get() return one by id. They need no protein: filter with plastic (and include_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" need protein or microorganism), paper_id, doi, polarity, evidence_method, substrate_form, measurement_type and has_quantitative. Experiments also take interaction_id, and observations interaction_id and experiment_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)
# }