Fix missing output files
BNR info-hub Technical Manual
1 Fix missing output files
1.1 Purpose
Use this guide when a table, figure, figure-ready data file, metadata file, or build file is missing from a static briefing bundle.
The expected source bundle for the case-count pilot is:
outputs/public/briefings/cvd_cases_2023_v1/
The expected website copy is:
site/downloads/files/briefings/cvd_cases_2023_v1/
2 Stage 1: Check the canonical output bundle
NoteStep 1. Check the source output folder
From PowerShell:
cd C:\yoshimi-hot\output\analyse-bnr\info-hub
Get-ChildItem outputs\public\briefings\cvd_cases_2023_v1 -RecurseExpected files include:
tables/cases_2023_sex_event.csv
tables/age70_2023_sex_event.csv
figures/cases_2023_cum_week.png
figures/cases_2023_age70.png
data/cases_2023_cum_week.csv
data/cases_2023_age70.csv
meta.yml
build.yml
WarningIf a file is missing here
If a file is missing from outputs/public/, do not create it by hand.
Rerun the Stata briefing DO file:
cd "C:/yoshimi-hot/output/analyse-bnr/info-hub"
do "scripts/stata/briefings/cvd_cases_2023/cvd_cases_2023.do"3 Stage 2: Check the site-accessible copy
NoteStep 1. Check the site copy
From PowerShell:
Get-ChildItem site\downloads\files\briefings\cvd_cases_2023_v1 -RecurseThe same Stata-generated files should appear in the site copy.
TipIf files exist in outputs/public but not site/downloads/files
Copy the approved bundle again:
$repo = "C:\yoshimi-hot\output\analyse-bnr\info-hub"
$source = "$repo\outputs\public\briefings\cvd_cases_2023_v1"
$target = "$repo\site\downloads\files\briefings\cvd_cases_2023_v1"
New-Item -ItemType Directory -Force -Path $target | Out-Null
Copy-Item "$source\*" $target -Recurse -Force4 Stage 3: Check naming
NoteStep 1. Check the briefing ID
The briefing ID must match across:
outputs/public/briefings/cvd_cases_2023_v1/
site/downloads/files/briefings/cvd_cases_2023_v1/
site/surveillance/cvd/briefings/case-counts.qmd
A broken link is often caused by a small mismatch such as case versus cases.
WarningDo not edit generated files manually
If a CSV, PNG, meta.yml, or build.yml is wrong, fix the code that created it and regenerate it.