Struct PmcArticle 

pub struct PmcArticle {
    pub article_type: Option<String>,
    pub front: Front,
    pub body: Option<Body>,
    pub back: Option<Back>,
    pub supplementary_materials: Vec<SupplementaryMaterial>,
    pub data_availability: Option<String>,
}

PMC full-text article.

Maps to JATS <article>: front, body?, back?.

DTD: https://jats.nlm.nih.gov/archiving/tag-library/1.4/element/article.html

Fields

article_type: Option<String>

Article type. From <article article-type="..."> attribute.

front: Front

Front matter. From <front>.

body: Option<Body>

Article body. From <body>. None when the article has no body (e.g., metadata-only records).

back: Option<Back>

Back matter. From <back>. None when the article has no back matter.

supplementary_materials: Vec<SupplementaryMaterial>

Supplementary materials. From <supplementary-material>, collected from the entire document (<body> sections, <back>, or <floats-group>).

data_availability: Option<String>

Data availability statement. From <sec sec-type="data-availability"> or <notes notes-type="data-availability">, wherever it appears.

Implementations

impl PmcArticle

pub fn pmcid(&self) -> &PmcId

PMC ID of this article (aggregate identity).

pub fn pmid(&self) -> Option<&PubMedId>

PubMed ID, if present.

pub fn doi(&self) -> Option<&str>

DOI, if present.

pub fn title(&self) -> Option<&str>

Article title, if present.

pub fn subtitle(&self) -> Option<&str>

Article subtitle, if present.

pub fn authors(&self) -> &[Author]

Authors.

pub fn journal(&self) -> &JournalMeta

Journal metadata.

pub fn pub_dates(&self) -> &[PublicationDate]

Publication dates.

pub fn categories(&self) -> &[String]

Subject categories.

pub fn volume(&self) -> Option<&str>

Volume number, if present.

pub fn issue(&self) -> Option<&str>

Issue number, if present.

pub fn keywords(&self) -> &[String]

Keywords.

pub fn funding(&self) -> &[FundingInfo]

Funding information.

pub fn history(&self) -> &[HistoryDate]

Publication history dates.

pub fn abstract_text(&self) -> Option<&str>

Text of the main abstract (first <abstract>), if present.

pub fn copyright(&self) -> Option<&str>

Copyright statement, if present.

pub fn license_text(&self) -> Option<&str>

License text, if present.

pub fn license_url(&self) -> Option<&str>

License URL, if present.

pub fn sections(&self) -> &[Section]

Body sections (empty slice when the article has no body).

pub fn references(&self) -> &[Reference]

References (empty slice when the article has no back matter).

pub fn acknowledgments(&self) -> Option<&str>

Acknowledgments, if present.

pub fn conflict_of_interest(&self) -> Option<&str>

Conflict of interest statement, if present.

pub fn get_tar_files(&self) -> Vec<&SupplementaryMaterial>

Get tar files from supplementary materials.

pub fn get_archive_files(&self) -> Vec<&SupplementaryMaterial>

Get all archive files from supplementary materials.

pub fn has_supplementary_materials(&self) -> bool

Check if the article has supplementary materials.

pub fn get_supplementary_materials_by_type( &self, content_type: &str, ) -> Vec<&SupplementaryMaterial>

Get supplementary materials by content type.

impl PmcArticle

pub fn all_sections(&self) -> SectionIter<'_>

Iterate every body section in the article, flattened depth-first in document order (parent before children).

This walks the entire <body> section tree so callers don’t have to recurse through Section::subsections manually.

pub fn sections_of_kind(&self, kind: &SectionKind) -> Vec<&Section>

All body sections whose semantic SectionKind matches kind (recursive). For example, article.sections_of_kind(&SectionKind::Methods).

pub fn sections_by_type(&self, sec_type: &str) -> Vec<&Section>

All body sections whose raw sec-type equals sec_type (case-insensitive, recursive).

pub fn find_section_by_title(&self, keyword: &str) -> Option<&Section>

First body section whose title contains keyword (case-insensitive, recursive). Handy for locating sections like “Statistical analysis”.

pub fn all_figures(&self) -> Vec<&Figure>

All figures across the whole article body (recursive over sections).

pub fn all_tables(&self) -> Vec<&Table>

All tables across the whole article body (recursive over sections).

pub fn all_formulas(&self) -> Vec<&Formula>

All display formulas across the whole article body (recursive).

pub fn all_cited_reference_ids(&self) -> Vec<&String>

All cited reference ids across the whole article body, in document order (recursive over sections). Each id targets a Reference::id in Back::references. See Section::cited_reference_ids.

pub fn figure_count(&self) -> usize

Number of figures in the article body.

pub fn table_count(&self) -> usize

Number of tables in the article body.

pub fn body_text(&self) -> String

Concatenated plain text of the whole article body, in reading order.

Section titles and paragraph content are joined with blank lines. Useful as a single input string for tokenizers, embeddings, or full-text search.

pub fn abstracts(&self) -> &[Abstract]

All abstracts (a JATS article may have several, e.g. a main and a graphical abstract).

pub fn abstract_sections(&self) -> &[AbstractSection]

Structured sections of the main (first) abstract, if it is structured.

pub fn references_with_pmid(&self) -> Vec<&Reference>

References that carry a PubMed ID (useful for building citation graphs).

pub fn references_with_doi(&self) -> Vec<&Reference>

References that carry a DOI.

pub fn references_by_type(&self, pub_type: &str) -> Vec<&Reference>

References whose publication_type equals pub_type (case-insensitive).

pub fn appendices(&self) -> &[Section]

Appendices (empty slice when the article has no back matter).

pub fn glossary(&self) -> &[Definition]

Glossary / abbreviation definitions (empty slice when absent).

pub fn supplementary_materials(&self) -> &[SupplementaryMaterial]

Supplementary materials attached to the article.

pub fn data_availability(&self) -> Option<&str>

Data availability statement, if present.

pub fn keyword_groups(&self) -> &[KeywordGroup]

Keyword groups (structured, with kwd-group-type / language).

pub fn subject_groups(&self) -> &[SubjectGroup]

Subject groups (structured, with subj-group-type).

pub fn related_articles(&self) -> &[RelatedArticle]

Related articles (corrections, retractions, companions, …).

pub fn corrections(&self) -> Vec<&RelatedArticle>

Articles corrected by this one (related-article-type="corrected-article").

pub fn retractions(&self) -> Vec<&RelatedArticle>

Articles retracted by this one (related-article-type="retracted-article").

pub fn author_notes(&self) -> &[String]

Author notes (correspondence / contribution / present-address statements).

Trait Implementations

impl Clone for PmcArticle

fn clone(&self) -> PmcArticle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PmcArticle

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PmcArticle

fn deserialize<__D>( __deserializer: __D, ) -> Result<PmcArticle, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PmcArticle

fn eq(&self, other: &PmcArticle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PmcArticle

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PmcArticle