Actris DVAS API Client

DVAS - Data Discovery, Virtual Access and Services - is a platform developed by Actris to facilitate the discovery, access, and use of atmospheric data. The Actris DVAS API provides programmatic access to the metadata in DVAS, allowing users to explore the available metadata.

This is the Python client for accessing the metadata in the Actris DVAS API. It provides a simple interface for retrieving metadata.

The metadata in DVAS is subject to the CC-BY-4.0 license, which means that you are free to use, share, and adapt the metadata as long as you give appropriate credit to the original source, provide a link to the license, and indicate if changes were made. For more information about the CC-BY-4.0 license, please visit Creative Commons.

Installation

You can install the Actris DVAS API client using pip:

pip install dvas-api-client

Basic Usage

#!/usr/bin/env python3

from pprint import pprint
from dvas.client import BoolQuery, QueryField, SortType, PROD_API
from dvas.client import search

query = (
    BoolQuery()
    .must(QueryField.DATASET_REPOSITORY_ID, "In-Situ")
    .must(QueryField.DISTRIBUTION_ACCESS_RESTRICTED, False)
    .filter_range(
        QueryField.TEMPORAL_EXTENT_BEGIN,
        gte="1979-01-01T00:00:00.000Z",
    )
    .sort([
        (QueryField.TEMPORAL_EXTENT_BEGIN, SortType.ASC),
        (QueryField.IDENTIFICATION_PID, SortType.ASC),
    ])
)

for doc in search(PROD_API, query):
    pprint(doc)