MTNA Rich Data Services Toolkit

Development Status CI Status License

A Python toolkit for programmatic interaction with MTNA Rich Data Services (RDS) servers.

This package enables data scientists, developers, and AI systems to discover, access, and analyze datasets from Metadata Technology North America (MTNA) Rich Data Services (RDS) servers with full support for metadata standards like Croissant and DCAT.

Warning

This project is in its early development stages. Stability is not guaranteed, and documentation is still being expanded. We welcome your feedback and contributions!

Key Features

  • Server Connectivity: Connect to MTNA RDS API endpoints with optional API key authentication

  • Metadata Discovery: Browse catalogs, search data products, and explore variables

  • Standard Metadata Formats: Generate Croissant JSON-LD for ML pipelines and DCAT/RDF for semantic web integration

  • Data Access: Query variables, inspect classification codes, and subset data products

  • Type Safety: Full type hints and Pydantic-based models for all APIs

  • HTML to Markdown: Automatic conversion of dataset descriptions for improved readability

Quick Example

from dartfx.mtnards import MtnaRdsServer

# Connect to a public RDS server
server = MtnaRdsServer(host="rds.highvaluedata.net")

# List available catalogs
for catalog_id, catalog in server.catalogs.items():
    print(f"{catalog_id}: {catalog.name}")

# Access a data product
catalog = server.catalogs['us-anes']
data_product = catalog.data_products_by_id['anes_1948']

# Generate Croissant metadata
croissant = data_product.croissant()

Documentation Contents

User Guide

API Reference

Development

Indices and Tables

Resources