API Reference

• hapi() - List available HAPI servers (get_servers)
• hapi(server, dataset, parameters) - Get parameter information for specific parameters (get_parameters)

get_data(server, dataset, parameters, tmin, tmax; format="csv", mask=true, kw...)

Get data and metadata from a HAPI server for a given dataset and parameters within a time range [tmin, tmax].

With mask = true, values equal to a parameter's fill read as NaN, so an integer parameter with a fill reads as Float64.

Supported keyword arguments:

• format = "csv": Data format (other options: "binary", "json").
• verbose = 0: Verbosity level passed to HTTP.get (other options: 1, 2).

get_data(path, tmin, tmax; kwargs...)

Get data and metadata using a path in the format "server/dataset/parameter".

An array-like object that represents a HAPI variable.

Fields

• data: The underlying data values (use parent(x) to access).
• time: The time axis (use times(x) to access).
• meta: The metadata (use meta(x) to access).

HAPIVariable(data, params, i; mask = true)

Construct a HAPIVariable object for parameter params[i + 1] from data: a CSV.File (or any Tables.jl table) in the HAPI CSV column layout, or a JSON-parsed response. With mask, values equal to the parameter's fill read as NaN.

A thin wrapper over NamedTuple for HAPI variables that shares the same time axis.

Server(id)

Get a HAPI server instance by its ID.

Examples

cdaweb = Server("CDAWeb") # same as HAPIClient.CDAWeb

get_data(server, dataset, parameters, tmin, tmax; format="csv", mask=true, kw...)

Get data and metadata from a HAPI server for a given dataset and parameters within a time range [tmin, tmax].

With mask = true, values equal to a parameter's fill read as NaN, so an integer parameter with a fill reads as Float64.

Supported keyword arguments:

• format = "csv": Data format (other options: "binary", "json").
• verbose = 0: Verbosity level passed to HTTP.get (other options: 1, 2).

get_data(path, tmin, tmax; kwargs...)

Get data and metadata using a path in the format "server/dataset/parameter".

• hapi() - List available HAPI servers (get_servers)
• hapi(server, dataset, parameters) - Get parameter information for specific parameters (get_parameters)

refresh_servers!(; url=DEFAULT_SERVERS_JSON_URL)

Fetch the latest server list from the remote URL and update the registry.

HAPIDataset(server, id)

The dataset id of a HAPI server.

HAPIParameter(dataset, name)
HAPIParameter(dataset, names)

dataset[name], whose getdata returns a HAPIVariable; dataset[names] fetches several parameters in one request as HAPIVariables.

HAPISchema <: MetadataSchema

Schema for HAPI parameter metadata.

References

• HAPI Parameter Object

Parameter

Represents a HAPI parameter with validation according to the specification.

Required fields:

• name: String identifier for the parameter
• type: One of "string", "double", "integer", or "isotime"
• units: String, array of strings, or nothing for dimensionless quantities
• fill: String or nothing indicating no fill value

Type-specific requirements:

• For string and isotime types: must specify length
• For array parameters: must specify size

Optional fields:

• description: Brief description of the parameter
• label: Display label or array of labels
• size: Array dimensions for array parameters
• bins: Array parameter bin information
• stringType: For string parameters that represent URIs
• coordinateSystemName: Name of coordinate system for vector quantities
• vectorComponents: Component names for vector quantities

HAPIDateTime(t)

Format t (a string or any Dates.TimeType) as a HAPI request time string, at millisecond precision unless t carries sub-millisecond digits.

Default format for HAPI servers.

get_capabilities(server)

Get server capabilities.

get_catalog(server)

Get a list of datasets available from the server.

HAPI info response JSON structure: https://github.com/hapi-server/data-specification/blob/master/hapi-dev/HAPI-data-access-spec-dev.md#35-catalog

get_parameters(server, id, parameters)

Get a dictionary containing the HAPI info metadata for each parameter in the comma-separated string parameters.

get_parameters(server, id)

Get a dictionary containing the HAPI info metadata for all parameters in the id dataset. Returns a tuple of (info, parameters) where info is the full response and parameters is a Vector of Parameter objects.

HAPI info response JSON structure: https://github.com/hapi-server/data-specification/blob/master/hapi-dev/HAPI-data-access-spec-dev.md#36-info

get_servers()

Get a list of available HAPI server URLs from https://github.com/hapi-server/servers/raw/master/all.txt

is_time_parameter(param::Parameter)

Check if a parameter is a valid time parameter (first parameter in a dataset).

load_servers_from_json(source=joinpath(@__DIR__, "abouts.json"); register=false)

Load HAPI servers from a local JSON file or remote URL.

Parse parameters into a Vector of Parameter objects and validate first parameter is time.

parse_hapi_time(s) -> Timestamp{Nanosecond}

Parse a (possibly truncated) HAPI time string, in yyyy-mm-dd or day-of-year yyyy-ddd form, with up to nanosecond precision.