plans.project

Project-related classes and routines

Overview

# todo [major docstring improvement] – overview Mauris gravida ex quam, in porttitor lacus lobortis vitae. In a lacinia nisl. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.

Functions

load_project(project_folder)	Loads a Project from folder
new_project(specs)	Create a new Project from a specification dictionary.

Classes

Project(name[, alias])

plans.project.new_project(specs)

Create a new Project from a specification dictionary.

Danger

This method overwrites all existing default files.

Parameters:

specs (dict) –

Dictionary containing project specifications.

Required keys:

• folder_base (str): Path where the project folder will be created.

• name (str): Name of the project.

Optional keys:

• alias (str): Alternative identifier. Defaults to None.

• source (str): Source reference. Defaults to empty string.

• description (str): Project description. Defaults to empty string.

Raises:

ValueError – If any required key is missing.

Returns:

A new :class:`plans.Project instance initialized with the given specifications.

Return type:

plans.Project

Examples

Import plans

import plans

Create a new plans.Project. First setup details.

# [CHANGE THIS] setup specs dictionary
project_specs = {
    "folder_base": "C:/plans", # change this path
    "name": "newProject",
    "alias": "NPrj",
    "source": "Me",
    "description": "Just a test"
}

Then call new_project()

plans.new_project(specs=project_specs)

Create and get the project instance:

prj = plans.new_project(specs=project_specs)

plans.project.load_project(project_folder)

Loads a Project from folder

Parameters:

project_folder (str or Path) – path to project root folder

Returns:

A new :class:`plans.Project instance.

Return type:

plans.Project

Notes

Warning

load_project() will overwrite the name attribute in project_info.csv file to match current folder name.

Examples

Import plans

import plans

Load an existing plans.Project

# get project instance
pj = plans.load_project(project_folder="path/to/project/folder")

class plans.project.Project(name, alias=None)

Bases: FileSys

__init__(name, alias=None)

_setup_run_folder(tool_name)

setter(dict_setter, load_data=False)

Set selected attributes based on an incoming dictionary.

Parameters:

dict_setter (dict) – incoming dictionary with attribute values

setup()

This method sets up the FileSys structure (default folders and files)

Danger

This method overwrites all existing default files.

update()

Refresh all mutable attributes based on data (including paths).

load_data()

Load data from file.

Parameters:

file_data (str) – file path to data.

make_run_folder(run_name)

get_metadata()

Get a dictionary with object metadata.

Returns:

dictionary with all metadata

Return type:

dict

Warning

Metadata does not necessarily include all object attributes.

get_basins()

get_scenarios_climate()

get_scenarios_lulc()

get_file(title, extras=None)

get_file_name(title)

get_folder(title, formatter)

run_demo()

run_analysis_dto(include_views=True, use_basin=None)

run_analysis_lulc_series(lulc_scenario, include_views=True, use_basin=None, use_old=False)

run_analysis_climate_series_lulc(climate_scenario, lulc_scenario, include_views=True)

run_analysis_soils_parameters(include_views=True)

run_analysis_lulc_parameters(lulc_scenario, include_views=True)

generate_dto()

generate_lulc_series(lulc_scenario=None, skip_lulc_scenario=None)

generate_climate_series_lulc(climate_scenario=None, lulc_scenario=None, skip_climate_scenario=None, skip_lulc_scenario=None)

generate_soils_parameters()

generate_lulc_parameters(lulc_scenario=None, skip_lulc_scenario=None)

static copy_output_files(folder_output, folder_dst, include_runfiles=False)

static move_output_files(folder_output, folder_dst, include_runfiles=False)

static handle_input_file(file_path)

static get_timestamp()