# OCHA anticipatory action — portfolio tracking

> The tracking record of OCHA's anticipatory action (AA) portfolio, as the open pages of https://ocha-dap.github.io/ds-aa-tracking/ show it: every framework on the map (a country and a hazard), its versions, pre-arranged funding and co-financing, activations and the money they released, and the people reached or targeted. Maintained by the data science team of OCHA's Centre for Humanitarian Data. Data snapshot 2026-11-15 03:38 UTC; files generated 2026-11-15.

**Caveat.** OCHA internal product under development, subject to change without warning. The figures may be incorrect and should not be used.

The map at https://ocha-dap.github.io/ds-aa-tracking/ is open, with no password. The site's other pages are not public yet: at their addresses a "Coming soon" page links to the development version of the site, behind a password. These files carry the data of the open pages, and only theirs (today: the map's); the data of the other pages will be added as those pages open. They are published openly on purpose: they are the interface for programs and AI assistants and need no password. Every file is regenerated from the database with each publish (nightly, and whenever the site or its data changes), in the same build as the map. The pages read in English, French and Spanish; these files are in English.

**Checked against the map.** At this build, every figure here was compared with the map's own (205 comparisons: each headline figure recomputed from the tables, each framework's figures, the figures aa-map.md states): all agree.

Counting rules (an LLM summing these files without them gets wrong totals):

- Pre-arranged funding is a STOCK: the envelope in place for a framework in a given year.
  Never add it across years, and never add it to released money. "Pre-arranged in 2026" is
  the sum over frameworks of the 2026 rows only (aa-prearranged-funding). The
  current year's figure comes from the framework records (source `framework-record`): for each
  live framework, the envelope of its most recent version that has one, all funds.
  `prearranged_usd` in aa-frameworks is that same figure per framework; its sum over the frameworks on the map's current-frameworks layer is the map's Pre-arranged tile (aa-map.md).
  Past years keep the reported series. It is not reduced by what activations released during the year.
- Two activations a year: a framework version whose document allows the trigger to activate
  twice in one season (`activations_per_year` = 2, some tropical-cyclone frameworks) has its
  CERF envelope COUNTED TWICE in every pre-arranged figure here, as on the pages. The amounts
  are already multiplied: never multiply again.
- Released money is what activations drew: the `funding` rows of aa-activations, net of any
  money refunded after an activation stopped (`refund_usd`). Two kinds: framework activations
  (`event_type` `framework_aa`) and non-framework allocations (`adhoc_aa`: anticipatory money
  allocated without a framework; they have no version and no window, and nothing is
  pre-arranged for them). Early action allocations are not anticipatory action and are not in
  these files.
- Layers, as on the site: every money row carries `layer` = `current` (a framework that is
  active, being updated or in development today), `retired` (a retired framework, in the
  years it was live) or `non_framework`. The map opens with the current-frameworks layer on
  and the current year: its stock figures (frameworks, pre-arranged, co-financing, people
  covered) count the frameworks on that layer (`map_layers` contains `framework` in
  aa-frameworks); its flow figures (activations, money released, people reached or targeted)
  count the year's framework activations of the frameworks on that layer; those of frameworks
  since retired count when the retired layer is on (the map's "All years, to today" switches it
  on), and non-framework allocations only when that layer is on. Add up the layers the question
  needs, and say which.
- A framework is one (country, hazard) pair. Regional frameworks do not exist: the Central
  America Dry Corridor is four national frameworks (El Salvador, Guatemala, Honduras and the
  retired Nicaragua), even where a document title calls it regional or one document serves
  several of them. One exception: a pair can also hold an EARLIER framework that a distinct
  new one replaced rather than revised (Somalia drought: the 2019-2021 food security
  framework, replaced by the 2026 one). Its versions, activations and money carry
  `replaced_framework` = true and the `retired` layer: they are a retired framework's, never
  the current framework's.
- Money comes from CERF and the Country and Regional Funds (the country-based pooled funds
  and the regional humanitarian funds), together the OCHA-managed funds. Pooled-fund
  pre-arranged money comes from the OneGMS allocation mirror (source `onegms-mirror`);
  hand-tracked rows are kept only for country-years the mirror does not cover, so the same
  money is never counted twice. Co-financing (money from outside the OCHA-managed funds,
  aa-cofinancing) is a separate stock: never add it to the pre-arranged figures.
- A framework version is one framework document: `endorsed`, or `development` while it is
  still being written. `lifecycle` says where the framework stands today: active, updating
  (being updated), development, pipeline or retired (defined under Vocabulary). Count
  frameworks by `lifecycle`, not by `status`.
- Return periods. For a whole framework version, `return_period_years` (aa-frameworks,
  aa-versions) is the figure the map's table shows: the one the document states where there is
  one, otherwise the backtest's (`return_period_basis` says which; both figures are given).
- People reached or targeted (the map's tile), per allocation of aa-activations' `funding` rows,
  each allocation once (`allocation_shared` marks a row whose allocation is counted on an earlier
  activation): a CERF allocation counts the people CERF reports reached (`people_reached`), or,
  while there is no report, the people it plans to reach or the activation targets
  (`people_planned`); a Country or Regional Fund allocation counts the people it targets
  (`people_planned`: its results are not available yet). It is not people covered (what the
  frameworks cover now).
- People covered (`people_covered`): a figure taken from a framework document that is not
  published is left out of these files, as it is of the open map.

## The map

- [The map in text](https://ocha-dap.github.io/ds-aa-tracking/aa-map.md): its headline figures as it opens (pre-arranged money, co-financing, people covered, this year's activations and the people reached or targeted), with the map's own notes on them, its frameworks and this year's activations.
- [The map's own data](https://ocha-dap.github.io/ds-aa-tracking/aa-map-data.json) (JSON, large): exactly what the map's page carries, without the drawing: every country, framework, version and activation, the country panels (trigger tables and windows, backtests, budget splits, partners, learning documents, sub-grantees) and the year selector's past years, with the headline figures (`headline`, `headline_non_framework`). Every field is described under "The map's data" below. The tables are easier to read; this file has everything the map shows.

## Data files

JSON: one object with `rows`, `columns`, a `description` and the stamps; every row carries every column (null where empty). CSV: the same rows; a nested value is JSON in its cell, a plain list is joined with `; `.

- [aa-frameworks.json](https://ocha-dap.github.io/ds-aa-tracking/aa-frameworks.json) · [CSV](https://ocha-dap.github.io/ds-aa-tracking/aa-frameworks.csv): The frameworks on the map: one row per (country, hazard) pair the open map shows (a pair drawn only for a non-framework allocation has no framework: its lifecycle and versions are blank), with its lifecycle, latest version, the return period of that version as the map's table shows it, the pre-arranged funding in place now (`prearranged_usd`, all funds; `prearranged_cerf_usd` its CERF part; the envelope of `prearranged_version`, counted twice where `activations_per_year` is 2; these sum to the current-year rows of aa-prearranged-funding), this year's co-financing (outside the OCHA-managed funds, never added to pre-arranged), people covered (blank where the figure comes from a framework document that is not published, as on the open map), the months its latest version is monitored, and `map_layers`: the map's layers the pair is drawn on (framework: current frameworks; retired; adhoc: non-framework allocations; tech: technical support only). Columns: country_iso3, country_name, region, hazard, lifecycle, status, retired, technical_support, latest_version, latest_version_status, current_version, valid_until, n_windows, n_windows_triggered, fully_triggered, return_period_years, return_period_basis, return_period_stated_years, return_period_backtest_years, prearranged_usd, prearranged_cerf_usd, prearranged_year, prearranged_version, activations_per_year, cofinancing_usd, people_covered, monitoring_months, map_layers.
- [aa-versions.json](https://ocha-dap.github.io/ds-aa-tracking/aa-versions.json) · [CSV](https://ocha-dap.github.io/ds-aa-tracking/aa-versions.csv): Every registered version of the frameworks on the map (`status`: an endorsed document, one still in development, or a retired one; `replaced_framework`: a version of an earlier framework that a distinct new one replaced): validity, the activations a year it allows, its overall return period, the document (`document_title`, `document_url` its official page), and the version's scope, trigger basis, indicators, data sources, monitoring months, implementing agencies and the people its document targets (`target_people`, blank where the document is not published and the figure is the framework's people covered, as on the open map). Columns: country_iso3, hazard, version, status, replaced_framework, valid_from, valid_until, activations_per_year, return_period_years, return_period_basis, return_period_stated_years, return_period_backtest_years, document_title, document_url, analysis_ref, geographic_scope, admin_level, data_sources, implementing_agencies, all_in, framework_doc, framework_doc_date, prearranged_funding_usd, trigger_basis, trigger_indicators, monitoring_months, target_people, cofinancing_sources, cofinancing_usd.
- [aa-activations.json](https://ocha-dap.github.io/ds-aa-tracking/aa-activations.json) · [CSV](https://ocha-dap.github.io/ds-aa-tracking/aa-activations.csv): Every real activation since 2020 on the map: framework activations (event_type framework_aa) and non-framework allocations (adhoc_aa: anticipatory money allocated without a framework), with the money each drew per fund (`funding`; `amount_usd` is their sum, net of any money refunded after the activation stopped, `refund_usd`; `provisional`: an amount entered before OCHA's grant management system recorded the allocation) and the people the map counts for it: `people_reached` CERF's figure (`people_reached_interim`: summed from its projects' reports, no final report yet); `people_planned` where there is no report, the people a CERF allocation plans to reach or the activation targets, and for a Country or Regional Fund allocation the people it targets. `allocation_shared`: the allocation serves several activations and its figures sit on the earliest one. `layer` and `replaced_framework` as in the counting rules. Early action is not included. Columns: country_iso3, country_name, hazard, event_type, event_date, window_name, event_label, version, layer, replaced_framework, people_targeted, amount_usd, fund_codes, funding.
- [aa-prearranged-funding.json](https://ocha-dap.github.io/ds-aa-tracking/aa-prearranged-funding.json) · [CSV](https://ocha-dap.github.io/ds-aa-tracking/aa-prearranged-funding.csv): Pre-arranged funding in place per framework, year and fund: a STOCK (the envelope standing that year), never summed across years. `version`: the version the envelope belongs to (blank for a pooled-fund allocation made at country level; hazard `multi` or `?` there means the country has several or no live framework). `activations_per_year` 2: the amount is already the envelope counted twice. `source`: framework-record (the current envelope), onegms-mirror (pooled-fund allocations), tracking-sheets (the team's reported series), version-inferred (carried from the version in force). `in_gho`: the country was in that year's Global Humanitarian Overview. Columns: country_iso3, hazard, year, version, fund_code, financier, amount_usd, activations_per_year, source, layer, replaced_framework, in_gho.
- [aa-cofinancing.json](https://ocha-dap.github.io/ds-aa-tracking/aa-cofinancing.json) · [CSV](https://ocha-dap.github.io/ds-aa-tracking/aa-cofinancing.csv): Co-financing pre-arranged for a framework: money from outside CERF and the Country and Regional Funds, recorded with the pre-arranged figures (the map's Co-financing tile and table column). A stock per year, never summed across years and never added to the OCHA-managed pre-arranged money. Past years: the yearly totals as reported for the year. The current year (`source` co-financing-now): each framework's co-financing now, as the map counts it: its yearly total, split by co-financer in the proportions its latest framework document states, or the document's own lines where no total is recorded; a framework whose pre-arranged money was all released by an activation has none now (its co-financing stays with its version in the database). `financier`: who provides it (`not recorded` where no one is named). How much of it was disbursed is not recorded. Columns: country_iso3, hazard, year, version, financier, amount_usd, source, layer, replaced_framework, in_gho.
- [aa-funds.json](https://ocha-dap.github.io/ds-aa-tracking/aa-funds.json) · [CSV](https://ocha-dap.github.io/ds-aa-tracking/aa-funds.csv): The funds behind every `fund_code` in these files: CERF and the Country and Regional Funds, that is the country-based pooled funds and the regional humanitarian pooled funds' country envelopes (`fund_type` cerf, cbpf or regional_fund; a name ending in a regional fund's acronym, such as AP-RHPF, marks a country envelope of that regional fund). Columns: fund_code, fund_type, name, country_iso3.

## The map's data (aa-map-data.json)

One JSON object: `year`; `headline` (the headline figures as the map opens, for the current year, on the current-frameworks layer) and `headline_non_framework` (the same figures for the non-framework allocations of the year); `countries` {ISO3: country}. Amounts in US dollars as recorded (not rounded). Fields by level:

**countries.ISO3**

- `name`: the country's name
- `region`: the OCHA region of the country
- `area_names`: {area code: area name} of the administrative areas the map draws for the country's frameworks (the codes in `scope.pcodes`)
- `subgrants`: the organisations CERF's anticipatory allocations in the country were sub-granted to, by agency: [{agency, partners: [{name, acronym, type (UN, INGO, NNGO, government, Red Cross / Red Crescent, other), usd}]}]
- `fws`: the country's frameworks, and the pairs drawn only for non-framework allocations or technical support: one object per (country, hazard) pair, fields below

**countries.ISO3.fws[] (one per pair)**

- `hazard`: drought, flood, storm, cholera, plague or food_insecurity for a framework; other hazards (locusts, for one) for a pair with non-framework allocations only; general for technical support not tied to one hazard (see `general`)
- `hz_label`: the hazard in words
- `status`: the operational status the team reports (early_conversations, advanced_conversations, under_development, active, activated_implementing, retired, ...); not the map's status
- `status_label`: `status` in words
- `disp`: the map's status of the pair, the one every figure counts by: active, updating (being updated) or development for a current framework; retired; pipeline (conversations only, drawn for technical support); adhoc (non-framework allocations only). Equals `lifecycle` in aa-frameworks where the pair has a framework
- `disp_label`: `disp` in words; for a `general` pair the page shows technical support instead
- `layers`: the map layers the pair is drawn on: framework (current frameworks), retired, adhoc (non-framework allocations), tech (technical support). The headline figures count pairs on `framework` (= `map_layers` in aa-frameworks)
- `tech`: OCHA supported the framework technically, with no funding
- `general`: true for technical support for anticipatory action in general, not for one hazard (hazard `general`, shown as 'No specific hazard'): technical support only, never a framework version or an allocation
- `ring`: `now` when an active framework is monitored this month (the map rings it)
- `latest`: the most recent version, of any status (= `latest_version`)
- `current`: the version the map and the country panel open on (the most recent)
- `in_force`: the version the tracking registry has in force
- `versions`: every version of the framework, oldest first: fields under version
- `activations`: every real activation on the pair, newest first: fields under activation
- `n_act`: framework activations of the pair's current framework
- `n_act_all`: activation records on the pair, of any kind
- `n_adhoc`: non-framework allocations on the pair
- `adhoc_cerf`: CERF allocations tagged as anticipatory on the pair outside any framework, from CERF's records: [{code (CERF's allocation code), year, emergency, title, usd, how (how it was matched to the pair), event, url (CERF's page), agencies, sectors, reached, planned}]
- `pre_now`: pre-arranged money now, all funds: what the Pre-arranged tile adds up (= `prearranged_usd` in aa-frameworks; two activations a year: the CERF envelope counted twice)
- `pre_parts`: `pre_now` split: {cerf, pooled (Country and Regional Funds), version (the version it is the envelope of), apy (activations a year counted)}; `pooled` again as cbpf (country-based pooled funds) + rhpf (regional humanitarian pooled funds, their country windows included), for the map's fund switch — never add them to `pooled`
- `apy`: activations a year counted in `pre_now`, where more than one
- `prearranged`: the registry's CERF figure of the in-force endorsed version: NOT the headline figure, which is `pre_now`
- `prearranged_year`: the year of `prearranged`
- `cofin_y`: co-financing pre-arranged, per year {year: usd}; the current year is co-financing now (= `cofinancing_usd` in aa-frameworks)
- `covered`: people covered now (blank: no figure, or one taken from a framework document that is not published)
- `hist`: what the year selector shows for past years: fields under hist
- `learning_docs`: learning products about the pair (after-action reviews, evaluations, activation reports, research): [{id, title, url, publisher, year (of publication), type, stat (a key statistic)}]

**fws[].hist**

- `sh`: the pair's status by date, [[date, status]]: a past year shows the last one before its end
- `cov`: people covered by date, [[date, people]] (a figure from a framework document that is not published is left out)
- `pre`: pre-arranged money per past year, {year: [usd, derived (1: carried from the version in force rather than reported for the year), activations a year counted, {cerf, cbpf, rhpf, all (no fund named)}: usd by the map's fund switch]}
- `retired`: the pair counts as retired
- `ret_on`: from when, derived (no retirement date is recorded): the day after its last version's validity ended, else the first status report saying dormant or retired
- `ret_note`: how `ret_on` was derived
- `adhoc`: the years with non-framework allocations on the pair

**fws[].versions[]**

- `v`: the version: the date of its endorsement (or of its document), or a year
- `status`: endorsed, development (not yet endorsed) or retired
- `valid_from`: start of validity
- `valid_until`: end of validity (can be past)
- `valid_until_source`: where the end of validity comes from: stated in the document, by convention, or inherited from an earlier version
- `dev_since`: in development since
- `endorsed_by`: who endorsed it: the Emergency Relief Coordinator for a major version, the CERF secretariat for a minor one
- `supersedes`: the version it replaces
- `superseded`: a newer endorsed version exists
- `fully_triggered`: nothing is left to release under it
- `doc_url`: the framework document's official page (ReliefWeb or unocha.org)
- `doc_title`: the document's title
- `doc_date`: the document's date
- `prearranged_doc`: the pre-arranged envelope the document states
- `envelope`: the version's pre-arranged envelope as recorded, all funds
- `env_cerf`: its CERF part
- `env_funds`: the envelope by fund: [{fund (a fund code: cerf, a country or regional pooled fund, or all = a total not split by fund), usd}]
- `pool_spent`: its Country or Regional Fund envelope was released by an activation
- `cofin`: co-financing the document states
- `cofin_sources`: who provides it, as the document says
- `regional`: one document serves several countries (each is still its own framework)
- `agencies`: implementing agencies
- `target_people`: the people the document targets (blank where the document is not published and the figure is the framework's people covered)
- `all_in`: one trigger releases the whole envelope
- `rollup`: how the windows' money adds up: additive, exclusive or all_in
- `n_windows`: number of trigger windows
- `months`: the months (1-12) the trigger is monitored
- `months_src`: where `months` comes from: stated (in the document), inferred, calendar sheet
- `months_note`: how the monitoring months were read from the document
- `basis`: what the trigger reads: forecast, observational or mixed
- `calibration`: how the trigger was calibrated
- `indicators`: the trigger's indicators
- `data_sources`: the data the trigger reads
- `triggers`: the trigger table as the document states it: one object per row, under the document's own column names (window, indicator, threshold, lead time, return period, releases, ...)
- `windows`: the trigger windows as recorded: [{name, basis, all_in, budget (usd), rp (the backtest's return period, years), prob (annual activation probability), sim (simulated activations), years (years analysed), triggered, triggered_on}]
- `backtest`: the historical simulation of the trigger: {start, end (years analysed), in_use_from, in_use_to (the years the version was in use: from then on only real activations count), windows, rows [{year, label, fired (the windows that would have activated), when, and for an event the backtest tested (aa.backtest_event): tested, na (the windows it could not be tested on: no record), vals {window: the trigger's value for it}}], per_event, n_after, after_note, and when events were tested: n_tested (how many, met or not), units {window: what `vals` measures}}
- `rp`: the overall return period the map's table shows, in years (any window activating in a year)
- `rp_st`: the return period the document states
- `rp_bt`: the one from the backtest
- `rp_src`: which of the two `rp` is: stated or backtest
- `apy`: activations a year the document allows
- `funding`: the version's pre-arranged budget split: {src (document: the framework document; sheet: the team's sheet), agency [{agency, fund, usd}], sector [{sector, fund, usd}], fund [{fund, usd}], pair [{agency, sector, usd}], cofin [{from (the financier), usd}]: the document's co-financing lines, kept out of the split}
- `partners`: organisations the document names: [{name, acronym, group, roles (tags), parent (the UN agency a sub-grantee works under), usd (the budget the document attaches, which can include its own co-financing)}]
- `partners_from`: the version whose list `partners` shows, where this one has none of its own
- `activities`: what each organisation does under the version once the trigger is met, in a line or two read from the version's public framework document (not the document's own words; no amounts or counts of people): [{agency, text, sector (as the document names it)}]
- `activities_from`: where this version has no lines of its own: the latest version of the same framework that has them (its lines are not repeated here)
- `learning`: lessons the version's record lists
- `admin_level`: the administrative level of the geographic scope
- `scope`: the areas drawn: {pcodes, unmatched (scope entries not matched to a map area), national, tiers [{label, pcodes, rest (a tier covering the rest of the country), whole (rest that covers the whole country, the named areas included)}]}
- `scope_raw`: the geographic scope as the document words it
- `scope_tiers_raw`: the document's tiers of areas, as worded
- `analysis_ref`: where the trigger analysis lives: repository@branch:path in the OCHA-DAP GitHub organisation
- `analysis_url`: its URL
- `doc_read`: the team has a structured read of the document
- `source`: where the version record comes from (aa-team, entered, ocha-web)

**fws[].activations[]**

- `date`: the event date, at the precision recorded (YYYY, YYYY-MM or YYYY-MM-DD)
- `exact_date`: a second record of the activation's date; the map takes the day from it when `date` gives only the month
- `type`: framework_aa (a framework's trigger) or adhoc_aa (a non-framework allocation)
- `window`: the trigger window, as recorded (can be a short code of the backtest)
- `version`: the version it activated under
- `old`: an activation of an earlier framework that a new one replaced: a retired framework's
- `people`: the people the activation targeted
- `url`: a public page on the activation
- `released`: the amount its public record states (the counted figure is the sum of `funding`)
- `full`: a full activation (the whole envelope)
- `funding`: the money released, per fund: fields under funding

**fws[].activations[].funding[]**

- `fund`: the fund code (see `fund_code` in the vocabulary)
- `code`: the fund's allocation code
- `fk`: [kind, region]: cerf, country (a country-based pooled fund), regional (a regional fund's envelope, with its region) or unrecorded
- `fs`: the map's fund switch box the row counts under: cerf, cbpf (a country-based pooled fund) or rhpf (a regional humanitarian pooled fund; a fund not recorded: the country's one registered fund)
- `usd`: released, net of any refund: what the tiles add up
- `refund`: money sent back after the activation stopped
- `prov`: entered before OCHA's grant management system recorded the allocation (an estimate)
- `cerf_url`: CERF's public page for the allocation
- `reached`: people reached, CERF's report
- `interim`: summed from project reports, no final report yet
- `planned`: the people counted while there is no report (CERF: those it plans to reach, else those the activation targets; a Country or Regional Fund: those it targets)
- `shared`: the allocation's people are counted on an earlier activation

**headline**

- `n_fw`: frameworks on the current-frameworks layer
- `n_ctry`: the countries they are in
- `n_active`: of them active
- `n_upd`: being updated
- `n_dev`: in development
- `pre`: pre-arranged now, all funds
- `pre_cerf`: its CERF part
- `pre_pooled`: its Country and Regional Funds part
- `pre_all`: its part not split by fund
- `pre_cbpf`: of the Country and Regional Funds part, the country-based pooled funds'
- `pre_rhpf`: of the Country and Regional Funds part, the regional humanitarian pooled funds'
- `apy`: [activations a year, country, hazard, hazard in words] of the frameworks counting more than one
- `cofin`: co-financing pre-arranged now
- `n_cofin`: frameworks with a co-financing figure
- `covered`: people covered now
- `n_cov`: frameworks with a figure
- `n_act`: framework activations this year
- `released`: money they released, net of refunds
- `released_cerf`: its CERF part
- `released_cbpf`: its country-based pooled funds' part
- `released_rhpf`: its regional humanitarian pooled funds' part
- `refund`: money returned after activations stopped
- `prov`: money estimated, not yet in OCHA's grant management system
- `n_nousd`: activations with no amount recorded
- `reached`: people reached, CERF's reports
- `n_rep`: CERF allocations with a report
- `n_interim`: of them interim
- `targeted`: people planned or targeted, CERF allocations awaiting reports
- `n_tgt`: those allocations
- `n_cerf`: CERF allocations
- `ptargeted`: people targeted by Country and Regional Fund allocations
- `n_ptgt`: those allocations
- `n_pool`: Country and Regional Fund allocations


## Vocabulary

- `country_iso3`: ISO 3166-1 alpha-3. `hazard`: drought, flood, storm, cholera, plague, food_insecurity for frameworks; non-framework allocations in aa-activations also carry other hazards (locusts, for one) and countries without a framework; `general` is technical support for anticipatory action not tied to one hazard (shown as 'No specific hazard': technical support only, never a framework version or an allocation).
- `lifecycle` (aa-frameworks), the one rule every page counts by: `active` the latest version is endorsed, within its validity and not fully triggered; `updating` (being updated) an endorsed framework whose latest version is in development, or whose latest version has fully triggered or passed its end of validity and awaits renewal; `development` no endorsed version yet; `pipeline` conversations only, nothing in development; `retired` no longer pursued. `status` is a different thing: the operational status the team reports for the framework (early_conversations, advanced_conversations, under_development, project_finalization, active, under_revision, activated_implementing, monitoring, dormant, expired, retired). It is observed separately and can lag `lifecycle`.
- Versions (aa-frameworks): `latest_version` the most recent version of any status; `current_version` the most recent one that is not in development, with `valid_until` its end of validity (which can be in the past; blank: none recorded). `n_windows` and `n_windows_triggered` count the windows recorded for the latest version; `fully_triggered`: that version has nothing left to release (any window for an all-in framework, every window otherwise; where no windows are recorded, a full activation under it). `technical_support`: OCHA supported the framework technically, with no funding. `retired`: flagged as retired by hand. `map_layers`: the map's layers the pair is drawn on (`framework` the current frameworks, `retired`, `adhoc` non-framework allocations, `tech` technical support).
- `replaced_framework` (aa-versions, aa-activations, aa-prearranged-funding, aa-cofinancing): the row belongs to an earlier framework on the same (country, hazard) pair that a distinct new framework replaced rather than revised; it counts as a retired framework's. `layer`: `current`, `retired` or `non_framework`, the site's layer toggles (see the counting rules).
- `activations_per_year` (aa-frameworks, aa-versions, aa-prearranged-funding): how many activations a year the version's document allows (1 for most). Where it is 2 the pre-arranged amounts already count the CERF envelope twice.
- Return periods: `return_period_years` the version's overall return period in years (any of its windows activating in a year), `return_period_basis` where that figure comes from (`stated in the framework` or `historical simulation`), with both figures in `return_period_stated_years` and `return_period_backtest_years`.
- version `status` (aa-versions): `endorsed`, `development` (not yet endorsed), `retired`. `analysis_ref`: where the trigger analysis lives, as repository@branch:path in the OCHA-DAP GitHub organisation. `monitoring_months` (aa-frameworks, aa-versions): the months (1-12) a version's trigger is monitored.
- People: `people_covered` (aa-frameworks) the people the framework covers, as last reported by the team (blank where the figure comes from a framework document that is not published); `target_people` (aa-versions) the people the version's document targets; `people_targeted` (aa-activations) the people one activation targeted; in the funding rows of aa-activations, `people_reached` the people a CERF allocation reached, from CERF's report (`people_reached_interim` true: summed from its projects' reports while there is no final one), and `people_planned` the people counted where there is no report (a CERF allocation's planned figure, else the people the activation targets; a Country or Regional Fund allocation's targeted figure). The map's tile adds, over the year's allocations, each once, the reported figure where there is one and the planned one otherwise. They are different figures: do not add people covered to people reached.
- `fund_code` (names in aa-funds): `cerf` the Central Emergency Response Fund; `cbpf-<iso3>` a country-based pooled fund, or a regional fund's envelope for that country where aa-funds says so; `rhpf-<region>-<iso3>` a regional humanitarian pooled fund's envelope for a country (`wca` West and Central Africa, `esa` Eastern and Southern Africa); `all` a pre-arranged total the source did not break down by fund; `cbpf-unspecified` a pooled fund the source did not name. `allocation_code`: the fund's own code for the allocation, as recorded (formats differ by fund and year; one allocation can serve several frameworks). `financier`: the fund's name where the source gave one.
- `event_type`: `framework_aa` an activation of a framework's trigger; `adhoc_aa` a non-framework allocation, anticipatory money allocated outside a framework.
- `window_name` (aa-activations): the trigger window as the tracking database records it, which can be a short code of the backtest (wt1, wg2, ws).
- Amounts are US dollars, to the dollar. Dates are ISO 8601. `event_date` keeps the precision recorded (YYYY, YYYY-MM or YYYY-MM-DD); `valid_from` and `valid_until` are full dates, so one known only to the month is written as its first day.


## Related

- Code and schema (public repository): https://github.com/OCHA-DAP/ds-aa-tracking
- OCHA anticipatory action: https://www.unocha.org/anticipatory-action
- CERF: https://cerf.un.org/