Introduction#

This quickstart guide provides instructions for creating and hosting a simple hub.

It will provide step by step directions to

  • [] Create a hub repository

  • [] Clone the hub repository to your local computer

  • [] Configure the modeling hub by:

    • [] Modifying admin.json

    • [] Modifying tasks.json

  • [] Upload modified files from your local computer to GitHub

  • [] Validate config files

Before diving into it step by step, we present a brief overview, and some pointers to resources developed by the Consortium to make designing, launching, and maintaining hubs easier.

Key concepts: Some of the concepts and terms used here may not be familiar to new users, and so we suggest that if you are unclear about a term, look at the key definitions page where we define terms such as “round”, “target”, “task”, and “Zoltar”.

Overview#

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.