Zoltar - The Forecast Archive¶
Welcome to the documentation site for Zoltar, a system developed by the Reich Lab in the Department of Biostatistics and Epidemiology at the University of Massachusetts Amherst to store time series forecasts.
Introduction¶
Zoltar is a web application to that hosts a repository of model forecast results. For many existing forecasting projects, predictions made by models have been stored in differing formats and locations or in sets of unstructured data files. This complicates tracking, comparing, visualizing and scoring forecasts. Zoltar supports storing, retrieving, comparing, and analyzing time series forecasts for prediction challenges of interest to many different modeling communities.
Getting started¶
Use the navigation links in the sidebar to get started touring the web site, reading the user guide, or learning about our python and R packages for interacting with the Zoltar API from your programming language.
Assumptions/Limitations¶
The scope of this first iteration is limited in these ways:
- Process-agnostic: By storing only core datasets, we make no assumptions about ML processes behind a model’s forecast, such as how it’s fit.
- Enforceability: There is currently not a method in place to test whether the models were fit on the right data subsets (this is something that pipeline-focused software such as mlr3, among others, could assist with).
- Unrevised vs. revised data: A Project’s core dataset may or may not include data revisions, such as those used to model or forecast reporting delays. Each project should give specific instructions on what type of data (revised vs. unrevised) is used in the training and testing phases of the forecasting.
- Model instances: The system stores only model metadata, rather than computable representations of models (internals) that could be used to reconstruct and re-run them.
- Reports: Some projects generate automated narrative reports from forecast data. This system does not support storing reports with their models.
- Training/testing data: The only information about what subsets of the core data were used for different ML stages (e.g. training vs testing) will be stored in narrative format in the project description.
- Reproducibility: Since this system stores data involved in forecasts and not source code, information about how to re-run models is only captured in narrative form in the model's description, and is linked to by the model's url field.
Funding¶
This work has been supported by the National Institutes of General Medical Sciences (R35GM119582). The content is solely the responsibility of the authors and does not necessarily represent the official views of NIGMS, or the National Institutes of Health.
Contact¶
- Email: If you have questions about this site, please contact us at zoltar@reichlab.io.
- Account requests: Please fill out the Zoltardata.com user request form to be added to our beta-tester invitation queue.
- Zoltar users email list: We have set up an email group at https://groups.io/g/zoltardata where Zoltar developers will make occasional announcements about important system changes, releases, etc. To subscribe either create a groups.io account and then add this group, or just send an email to zoltardata+subscribe@groups.io to auto-create an account.
- GitHub repository issues: Zoltar is under active development, so you may have questions, encounter issues, or want new features. Please feel free to create issues for us at https://github.com/reichlab/forecast-repository/issues.