Annotator Service
Overview
The Annotator Service is a component of the NCATS Biomedical Data Translator program that provides comprehensive annotations for biomedical entities. The service aggregates and normalizes information about genes, diseases, chemicals, phenotypes, and other biomedical concepts from multiple authoritative knowledge sources, delivering rich metadata to support entity resolution, semantic interoperability, and knowledge integration across the Translator ecosystem.
Key Features
Entity Annotation
- Comprehensive Metadata: Aggregates detailed information about biomedical entities
- Multi-Source Integration: Combines data from multiple authoritative sources
- Synonym Resolution: Provides alternative names and identifiers for entities
- Cross-References: Links entities across different databases and ontologies
- Hierarchical Relationships: Includes taxonomic and ontological classifications
Supported Entity Types
- Genes and Proteins: Gene symbols, protein names, molecular functions
- Diseases and Phenotypes: Disease names, clinical manifestations, inheritance patterns
- Chemical Substances: Drug names, compound identifiers, chemical structures
- Biological Processes: Pathways, cellular processes, molecular functions
- Anatomical Entities: Organs, tissues, cellular components
- Organisms: Species, strains, taxonomic classifications
Semantic Enrichment
- Descriptions: Human-readable summaries of entities
- Definitions: Formal ontological definitions
- Categories: Biolink Model type classifications
- Attributes: Key properties and characteristics
- Evidence: Provenance and source attribution
Architecture
Data Integration
- Aggregates annotations from Translator Knowledge Providers
- Accesses curated databases and ontologies
- Utilizes Node Normalization service for identifier resolution
- Maintains cross-reference mappings
API Interface
- RESTful API endpoints
- Entity lookup by identifier or name
- Batch annotation requests
- Configurable response details
- JSON response format
Use Cases
Entity Resolution
- Resolving ambiguous entity references
- Mapping between identifier systems
- Finding canonical identifiers
- Discovering synonyms and aliases
Knowledge Enhancement
- Enriching query results with metadata
- Providing context for entities
- Supporting entity disambiguation
- Enhancing user interfaces with descriptions
Semantic Interoperability
- Standardizing entity representations
- Bridging terminology systems
- Supporting Biolink Model alignment
- Facilitating cross-resource integration
Integration with Translator
The Annotator Service supports other Translator components:
- Autonomous Relay System (ARS): Enriches query results
- Autonomous Relay Agents (ARAs): Enhances entity information in responses
- Knowledge Providers (KPs): Normalizes entity representations
- User Interfaces: Provides display-ready entity metadata
Data Sources
The service aggregates annotations from:
- Gene and protein databases (UniProt, HGNC, Ensembl)
- Disease ontologies (MONDO, DO, OMIM)
- Chemical databases (ChEBI, PubChem, DrugBank)
- Phenotype ontologies (HPO, MP)
- Biological ontologies (GO, SO, Uberon)
- Translator Knowledge Providers
Technical Details
Access Methods
- API Endpoint: Programmatic access via REST API
- Request Types: Entity lookup, batch annotation
- Response Format: JSON with structured metadata
- Authentication: May require API credentials
- Caching for frequently accessed entities
- Batch request optimization
- Distributed architecture for scalability
Applications
Translational Research
- Entity identification in clinical queries
- Literature mining support
- Drug repurposing candidate annotation
- Disease mechanism exploration
Data Integration
- Harmonizing entity references across databases
- Supporting knowledge graph construction
- Enabling federated queries
- Facilitating data exchange
User Experience
- Providing informative entity tooltips
- Supporting autocomplete functionality
- Displaying rich entity cards
- Offering exploration starting points
This resource has the Information Resource identifier: infores:annotator
Documentation
For detailed API documentation and usage examples, visit:
- Translator Wiki: https://github.com/NCATSTranslator/Translator-All/wiki/Annotator-Service
- Translator Website: https://ncats.nih.gov/translator