Skip to contents

Engineered variants of wild-type proteins: their mutations, engineering method and evidence. Records, FASTA and lists answer a pinned release too; only the structure is live only (a pinned client gets plasticdb_release_live_only).

Usage

variants_list(..., limit = Inf, client = plasticdb_client())

variants_get(
  ref,
  include_sequenceless = FALSE,
  follow_merges = FALSE,
  client = plasticdb_client()
)

variants_of(parent, limit = Inf, client = plasticdb_client())

variants_sequences(..., limit = Inf, client = plasticdb_client())

variants_fasta(ref, client = plasticdb_client())

variants_structure(ref, path = NULL, client = plasticdb_client())

Arguments

...

Filters (see Details), named as the API names them.

limit

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

client

A plasticdb_client().

ref

A variant accession or numeric id.

include_sequenceless

Include records without a sequence.

follow_merges

Return the survivor of a merged accession.

parent

The parent protein's accession.

path

For proteins_structure(), a file or directory to write to.

Value

As for proteins: tibbles with provenance, plasticdb_record lists, an Biostrings::AAStringSet, or text.

Details

  • variants_list() lists variants matching the filters in ... (proteins_list(kind = "engineered"); see proteins for the filters).

  • variants_get() returns one variant by accession or numeric id. Merges behave as in proteins_get(); a withdrawn variant (also one whose parent protein was withdrawn) signals plasticdb_gone. On a past release the record comes from its snapshot: a variant the release did not contain is plasticdb_not_found (merges are not followed there), include_sequenceless = TRUE is plasticdb_release_unsupported_filter, and the fields it cannot fill are in last_response()$unavailable_fields.

  • variants_of() lists the variants of one parent protein, with sequences (the same as proteins_variants()).

  • variants_sequences() returns the listed variants' sequences as an Biostrings::AAStringSet.

  • variants_fasta() and variants_structure() are one variant's FASTA record and structure coordinates.

Examples

variants_of("PBFCTW", limit = 3)[, c("accession", "variant_name")]
# \donttest{
variants_get("PBDTZX")$variant_name
variants_sequences(plastic = "PET", limit = 5)
# }