Resume where you left off
Online at https://diogoribeiro7.github.io/analytics-blog-jekyll/2024/04/11/dataset-announcement-schema/
Topics
Today we are releasing the Retail Demand Benchmark dataset to help analytics teams evaluate forecasting models under realistic constraints. The DataLog theme lets you pair documentation, schema tables, and governance checklists in one place.
Download options
retail-demand-benchmark.csvvia the dataset page- Parquet export via
_datasets/retail-demand-benchmark.md - Companion notebook:
_notebooks/batch-anomaly-detection.ipynb
Schema
| Column | Type | Description |
|---|---|---|
date |
Date | Week-ending timestamp |
store_id |
String | Unique store identifier |
category |
String | Product category slug |
units_sold |
Integer | Units sold in the week |
price |
Decimal | Average selling price |
promo_flag |
Boolean | Promotion indicator |
stockout_minutes |
Integer | Minutes unavailable due to stockouts |
Usage guidelines
1
2
3
4
5
6
7
8
9
10
11
data_quality:
freshness: P1D
source_system: retail_warehouse
owners:
- name: Diogo Ribeiro
email: diogo.debastos.ribeiro@gmail.com
- name: Analytics Platform Team
email: platform@example.com
sla:
anomalies: notify-analytics-oncall@example.com
completeness: >= 0.98
Governance tip: Store ownership metadata in
_data/catalog.ymlso the theme can surface it across dataset and notebook pages.
Next steps
- Publish baseline forecasts and accuracy benchmarks in the notebooks collection.
- Embed interactive Plotly charts showing store-level variability.
- Solicit community contributions via GitHub Discussions and credit accepted pull requests in the showcase gallery.
With schema documentation and ownership metadata in place, teams can trust the dataset before wiring it into production pipelines.
Your private highlights
Kept in this browser only and never sent anywhere. These are your notes, not comments. With text selected, Alt+Shift+H highlights it and Alt+Shift+N adds a note.
This browser is not letting the site keep data, so saving, progress and highlights are off.
Select a passage of the article to highlight it.
Your reading data
Embed interactive plots, widgets, and demos using <figure>, <iframe>, or <div class="interactive-embed"> containers. Ensure each embed includes descriptive captions for accessibility.
© 2024 Diogo Ribeiro. Text and figures under CC BY 4.0.
How to cite
Use the quick export buttons to save citations for reference managers or copy the formatted text directly.
Diogo Ribeiro (2024). Dataset Announcement – Retail Demand Benchmark. DataLog | Data Science & Research Theme. https://diogoribeiro7.github.io/analytics-blog-jekyll/2024/04/11/dataset-announcement-schema/.
BibTeX
RIS
EndNote
Open science & reproducibility badges
These badges highlight the transparency practices applied to this work. Hover or focus on each badge to learn more about the criteria.
- Open Data Dataset and code repository published with permissive license. Public repository, DOI issued, README with reproduction steps.
- Reproducible Workflow Containerized environment and automated tests provided. Continuous integration pipeline with reproducibility checks.
- Transparent Peer Review Peer review reports archived with DOI and linked to article. Open peer review statement and archived reports on Zenodo.