Project Management

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

apply_map_theme

Restores a previously saved map theme (layer visibility and style), created with create_map_theme -- switches the project's current view between different named map product states.

Parameter	Type	Required	Description
theme_name	string	yes

create_map_theme

Saves the current layer visibility/style state as a named map theme, so it can be restored later with apply_map_theme -- for producing several different map products (e.g. 'overview', 'health facilities only', 'roads and admin boundaries') from one project without manually toggling layer visibility every time. Point 16 of docs/QGIS_PRODUCTION_ARCHITECTURE_REVIEW_2026-09-04.md.

Parameter	Type	Required	Description
theme_name	string	yes	Name for the saved theme.

create_project_folder_structure

Creates the recommended humanitarian-GIS project folder layout (data/00_raw for immutable source data, 10_staging/20_processed for derived work, plus styles/models/scripts/exports/metadata/logs) under a base directory. Opt-in only -- call this ONLY when the user explicitly asks for a standard project structure; never on your own initiative, since many users already work inside an org-mandated data structure this would duplicate. Never overwrites or deletes anything -- only creates folders that don't already exist.

Parameter	Type	Required	Description
base_path	string	yes	Absolute path to the project root the folder structure should be created under, e.g. 'C:/projects/flood_response'. Created if it doesn't exist.

list_map_themes

Lists the names of every map theme saved in the current project via create_map_theme.

No parameters.

load_project

Open a different QGIS project file, replacing everything currently loaded. Destructive: any unsaved changes in the current project are lost -- save_project first if they matter.

Parameter	Type	Required	Description
file_path	string	yes	Absolute path to a .qgz/.qgs project file.

save_project

Save the current QGIS project (all layers, styles, and layout) to a .qgz/.qgs file. Use this as a checkpoint before a risky multi-step operation, or at the end of a task so the user's work is persisted. Temporary (memory) layers are NOT saved with their data -- the result lists them and they must be exported to a file separately.

Parameter	Type	Required	Description
output_path	string	no	Absolute path to save to, e.g. 'C:/maps/analysis.qgz'. Omit to save to the project's current file path (if it has one).