find_invalid_letters: Find elements which are not suitable for specified type.

In tidysq: Tidy Processing and Analysis of Biological Sequences

Find elements which are not suitable for specified type.

Description

Finds elements in given sequence not contained in amino acid or nucleotide alphabet.

Usage

find_invalid_letters(x, dest_type, ...)

## S3 method for class 'sq'
find_invalid_letters(
  x,
  dest_type,
  ...,
  NA_letter = getOption("tidysq_NA_letter")
)

Arguments

x	[sq] An object this function is applied to.
dest_type	[character(1)] The name of destination type - one of "dna_bsc", "dna_ext", "rna_bsc", "rna_ext", "ami_bsc" and "ami_ext".
...	further arguments to be passed from or to other methods.
NA_letter	[character(1)] A string that is used to interpret and display NA value in the context of sq class. Default value equals to "!".

Details

Amino acid, DNA and RNA standard alphabets have predefined letters. This function allows the user to check which letters from input sequences are not contained in selected one of these alphabets.

Returned list contains a character vector for each input sequence. Each element of a vector is a letter that appear in corresponding sequence and not in the target alphabet.

You can check which letters are valid for specified type in alphabet documentation.

Value

A list of mismatched elements for every sequence from sq object.

See Also

alphabet()

Functions that manipulate type of sequences: is.sq(), sq_type(), substitute_letters(), typify()

Examples

# Creating objects to work on:
sq_unt <- sq(c("ACGPOIUATTAGACG","GGATFGHA"), alphabet = "unt")
sq_ami <- sq(c("QWERTYUIZXCVBNM","LKJHGFDSAZXCVBN"), alphabet = "ami_ext")

# Mismatched elements might be from basic type:
find_invalid_letters(sq_ami, "ami_bsc")

# But also from type completely unrelated to the current one:
find_invalid_letters(sq_unt, "dna_ext")

tidysq documentation built on April 12, 2025, 1:37 a.m.