Skip to main content
AtlasStat 0.2.0 is now in local testing. Join the list for availability updates.
See how AtlasStat configures a publication and produces each release from traceable statistical facts.
Author

Iliass Taleb

How it works

Set up the publication with your reporting team, then reuse the specification for each new release.

Phase A · With the reporting team

Configure the publication

Setup is collaborative and specific to each publication.

  1. Define the report tree. Set the hierarchy from report to sections, subsections, paragraphs and sentences. Place charts, tables and approved standard text.
  2. Map sentences to facts. Specify what each sentence must communicate and link its facts to the team’s reporting data.
  3. Connect original production tables. Build reproducible R transformations for reporting data and derived indicators.
  4. Save the reusable specification. YAML fact specifications describe the evidence needed. YAML structure files define the hierarchy, order and references used in assembly.

Phase B · For every new release

Produce each release

  1. Import new production tables. Preserve the source version and run the R pipeline.
  2. Generate facts and graphics. R performs the calculations and deterministically generates updated YAML fact files, tables and charts.
  3. Write and verify. AI drafts sentences from assigned facts and supports semantic checking. Numerical and semantic checks flag unsupported claims, missing facts and incorrect values.
  4. Translate and verify. AI helps create language versions using approved terminology and the same facts. Checks preserve numerical values while allowing locale-specific formatting.
  5. Assemble progressively. Deterministic code handles ordered assembly where possible, from paragraphs through subsections and sections to the report. Insert tables and charts, save intermediate outputs and check consistency at each level.
  6. Style and review. Apply institutional presentation rules and produce Word and PDF outputs for final human approval.

Report structure

How sentences use facts

A sentence is the smallest writing unit and can draw on several facts. Teams can revise the specification when their publication or methodology changes.

How facts fit into the report tree

Report → Section → Subsection

  • Paragraph
    • SentenceCurrent valuePrevious valueAnnual change
    • Next sentence

Illustrative example · Fictional data

Trace a sentence to its source

  1. Source values

    Production index
    2023 2024
    100.0 104.0

    Unit: index points
    Reference: fictional table T1

  2. R calculation

    (104.0 ÷ 100.0 − 1) × 100

    Percentage change relative to 2023.

  3. Structured fact

    Annual change: +4.0%
    Period: 2024 vs. 2023
    Unit: percent
    Source: T1, both annual values

  4. Generated sentence

    “The production index increased by 4.0% in 2024 compared with 2023.”

Built for transparent reporting

Reproducible and auditable. R calculations can be rerun from versioned source tables. Text, tables and charts share the same facts, and saved intermediate outputs let reviewers trace claims, check the evidence and recheck affected outputs after revisions.

Consistent across languages and formats. Translation uses approved statistical terminology and keeps the same underlying facts. The organization’s styling carries through to Word and PDF, with final approval resting with the reporting team.

Free publication setup. After testing, AtlasStat intends to offer setup and collaboration free of charge. Any third-party running costs would be discussed beforehand.