Getting started
Contents
Getting started#
The following subsections provide pointers to resources developed by the Consortium to make designing, launching, and maintaining hubs easier.
The simplest way to set up a modeling hub is to directly clone one from the template hub repositories or to use one of the example hub repositories, which are based on prior use cases. The template hubs provide a skeletal structure of a hub without any data in them, whereas the example hubs provide minimal working examples of hubs and could be used for ideas of how to set up configuration files for new projects.
Template hubs#
The hubTemplate
repository (under development) provides a skeleton structure for groups wishing to build and maintain a new modeling hub. This repository may be cloned to start a new repository for a modeling hub.
Example hubs#
The example Hub repositories provide minimal working examples of hubs that can be used for ideas of how to set up configuration files for new projects. They are also used as use-cases for testing the software for modeling hubs.
1. Simple Forecast Hub Example#
The Simple Forecast Hub Example is adapted from forecasts submitted to the US COVID-19 Forecast Hub, but has been modified to provide examples of nowcasts.
2. Complex Forecast Hub Example#
The Complex Forecast Hub Example is designed to be similar to the US COVID-19 Forecast Hub and the European COVID-19 Forecast Hub.
3. Complex Scenario Hub Example#
The Complex Scenario Hub Example is designed to be similar to the US COVID-19 Scenario Modeling Hub
Schema files#
To take advantage of the infrastructure designed by the Consortium, a hub must contain JSON configuration files in a specific location and format. The schemas that define the structure and formats of the configuration files live in their own schemas repository. The schemas are versioned, and every hub must point to a specific version of the schemas that they are using.
Software for modeling hubs#
The main benefit of setting up a hub using the structure outlined in this documentation is that it enables you to use a wide array of tools designed to support common modeling hub tasks, like loading model output data, plotting the model output data, building ensembles using the data, and in some cases evaluating the predictions made by different models.