AVPR: ARC validation package registry
The AVPR indexes and hosts validation packages for Annotated Research Contexts (ARCs) in a central registry. You can learn more about the concept of ARCs here
It is intended for 2 main use cases:
- Summarize available packages and make them discoverable and inspectable for users that want to incorporate them in their Continuous Quality Control (CQC) workflows locally or on the DataHUB. This is done by providing a package browser website
- Provide programmatic access for downloading and veryfing validation packages. This is done by providing Public API Endpoints
ARC validation package browser
The ARC validation package browser provides a overview of all available validation packages. You can browse the list of packages and view package details such as tags, author(s), release notes, and the validation code.
For each package, you can also find a link to the respective script in the package staging area, where you can propose changes or new versions.
ARC validation package API
For downstream tools that want to programmatically query and download available validation packages, AVPR provides a extensively documented public API.
OpenAPI specs and documentation of this API can be accessed here
Note that packages published on AVPR are intended to be immutable after publication. Therefore, any endpoints that can push changes to the database are authorization-only, and not intended to be used by any user-facing tool.
If you have good reasons to request an API key for authorizing to these endpoints, feel free to contact us via an GitHub issue.
Frequently asked questions
What is an ARC validation package?
A validation package bundles a collection of validation cases that an ARC MUST pass to qualify as valid in regard to the validation package with instructions on how to perform the validation and summarize the results.
Validation packages are part of the ARC specification 2.0 draft which can be previewed here
Validation packages hosted on AVPR are implemented as scripts using the reference implementation ARCExpect
How can I use a validation package?
While you can download it directly from the AVPR browser, we strongly recommend installing validation packages either with arc-validate - DataPLANT's reference implementation for managing and executing validation packages, or use CQC pipelines on the DataPLANT's reference PLANTDataHUB instance
What is Continuous Quality Control (CQC)?
Continuous Quality Control is a core concept of DataPLANT's research data management stack. In short, it refers to continuously collecting and reporting selected quality metrics of an ARC during its whole lifecycle. This can cover quality of metadata annotations, exportability to endpoint repositories, and much more. One way of achieving this is canstantly validating an ARC against validation packages.
For more information on CQC, please have a look at our PLANTDataHUB paper
How can i contribute my own validation package?
In short, you create a validation package by submitting it to the AVPR staging area on GitHub. Once it is reviewed and approved, it will be published and available for download and use by others.
The process of submission with the correct metadata is extensively documented here
The process of writing validation packages with the ARCExpect reference implementation is documented here
How can i validate my ARC locally?
arc-validate can be used locally to manage validation packages and validate ARCs against them.