The six workflows

This page is generated from the repository on every merge to main; changes made here are overwritten.

The humanitarian tools follow six workflows: field operations first, then strategic orchestration. Tools marked new were added in the two most recent releases and have been tested offline and in CI on QGIS 4.2.2, not by hand. For what each tool does, what it draws and how to get better results, read the Tools catalogue; exact arguments are in the Tool reference.

#	Workflow	In one line
1	Rapid crisis and base mapping	Boundaries, OSM, footprints, imagery, change detection, damage exposure, mapping task grids
2	MSNA and field data	Sampling frames, population, tabular and PDF/Word table intake, survey indicators
3	Logistics, routes and catchments	Road speeds, impedance, barriers, service areas, travel-time matrices, hub siting, allocation, delivery routes, critical links
4	Severity mapping (JIAF-style)	Severity indices, presence gaps, 3W, population in need, hotspots, trends, JIAF 2 analysis support
5	Allocation and prioritisation	MCDA ranking, funding data, sector coverage, weighted overlay, allocation envelope
6	Anticipatory action	Forecast triggers, hazard feeds, incident search, dashboards, scheduled monitoring

Two further groups cut across them: data quality and governance (P-code checks, schema contracts, dataset status, provenance, sensitivity, QA checklists) and reporting and products (charts, dashboards, spatial reports, the humanitarian look).

Judgement calls are asked for, not chosen

Where a number is a judgement call (a trigger threshold, criteria weights, a design effect, a minimum survey cell size) the tool asks you for it and repeats it in the result instead of choosing one.

JIAF 2 analysis support

The JIAF 2 tools compute what the OCHA worksheet specifies and record what is an analyst decision. Every result carries two open validation blockers on purpose: (1) the flag formulas have not been compared with a real country's Flags dashboard export, and (2) the Annex 4 reader (an unsupported optional format) has not seen a real filled sector-input file. Results say "not the JIAF method, not endorsed by OCHA or the IASC". See the Status and open work page.

The tools, by workflow

Workflow	Tools
1. Rapid crisis and base mapping	search_hdx_datasets, fetch_hdx_admin_boundaries, fetch_geoboundaries, fetch_osm_features, ingest_osm_features, fetch_building_footprints, search_stac_satellite_imagery, calculate_raster_change_detection, calculate_damage_exposure_severity, extract_features_from_imagery, add_incident_point, add_point_layer, generate_mapping_task_grid, import_humanitarian_table
2. MSNA and field data	design_sampling_frame, fetch_worldpop_population, estimate_population_exposure, load_tabular_data_as_layer, extract_pdf_tables, extract_word_tables, aggregate_data, aggregate_survey_indicator
3. Logistics, routes and catchments	estimate_road_speeds, build_composite_impedance_field, apply_network_barriers, calculate_service_area, classify_facilities_by_access, travel_time_matrix, population_access_gap, optimal_hub_siting, location_allocation, optimize_delivery_route, score_route_incident_risk, analyze_critical_links
4. Severity mapping (JIAF-style)	calculate_severity_index, calculate_presence_gap, load_3w_data, calculate_population_in_need, hotspot_analysis, analyze_incident_trend, forecast_trend, import_jiaf_inputs, record_jiaf_setup, get_jiaf_setup, compute_jiaf_preliminary, record_jiaf_decisions, get_jiaf_decisions, finalize_jiaf_results, compute_jiaf_patterns
5. Allocation and prioritisation	calculate_mcda_ranking, fetch_fts_funding_data, generate_sector_coverage_report, weighted_overlay_analysis, calculate_allocation_envelope
6. Anticipatory action	evaluate_forecast_trigger, fetch_gdacs_disaster_alerts, fetch_nasa_eonet_events, fetch_usgs_earthquakes, fetch_ucdp_conflict_events, find_incident_reports, search_fact_checks, fetch_nasa_active_fires, generate_situation_dashboard, run_monitoring_workflow, schedule_recurring_workflow, stop_recurring_workflow, list_scheduled_workflows
Data quality and governance	check_pcode_uniqueness, check_pcode_hierarchy, validate_schema, list_schema_contracts, get_dataset_status, set_dataset_status, advance_dataset_status, get_provenance_record, write_provenance_sidecar, set_layer_sensitivity, get_layer_sensitivity, generate_map_product_qa_checklist
Reporting and products	generate_chart, generate_html_dashboard, generate_temporal_dashboard, generate_spatial_report, generate_report, apply_humanitarian_look
Engineering hydrology	parse_dms_location, assess_watershed_hydrology_request, calculate_rational_watershed_peak_flow