parse_linucs: Parse LINUCS Structures

In glyparse: Parsing Glycan Structure Text Representations

Parse LINUCS Structures

Description

Parse LINUCS strings into a glyrepr::glycan_structure(). LINUCS is a tree-oriented glycan format that writes each residue as a linkage token, a residue token, and a braced child list, for example "[][Hexp]{[(4+1)][Hexp]{}}".

Usage

parse_linucs(
  x,
  on_failure = "error",
  progress = FALSE,
  validate = lifecycle::deprecated()
)

Arguments

x	A character vector of LINUCS strings. NA values are allowed and will be returned as NA structures.
on_failure	How to handle parsing failures. "error" aborts when a structure cannot be parsed. "na" returns NA at invalid positions.
progress	Whether to show a progress bar while parsing.
validate	Deprecated and ignored. Array records are always validated by glyrepr::structure_from_arrays().

Details

LINUCS linkages are written as "(parent+child)", where parent is the linkage position on the parent residue and child is the anomeric linkage position on the child residue. Residue labels are normalized to the monosaccharide and substituent vocabulary used by glyrepr::glyrepr. A -ol suffix on the root residue is retained as alditol status.

Value

A glyrepr::glycan_structure() object.

Examples

linucs <- "[][b-D-Glcp]{[(4+1)][b-D-Galp]{}}"
parse_linucs(linucs)

glyparse documentation built on Oct. 30, 2026, 9:10 a.m.