Study objectives

Study objectives are study endpoints from the user perspective. A study objective corresponds to an expected output for the user. In pyaesa, five study objectives are currently available:

Study objective	Corresponding output for the user
`A`	Life-cycle assessment (LCA/IO-LCA)
`B.0`	Dynamic carrying capacity (CC)
`B.1`	Allocated share of carrying capacities (aSoCC)
`B.2`	Allocated carrying capacities (aCC)
`C`	Absolute sustainability ratio (ASR)

High-level overview of pyaesa with main functions, study objectives, and prerequisites.

pyaesa automatically orchestrates functions to reach study objectives

It is very important for the user to understand that to reach a desired study objective, pyaesa automatically orchestrates the call of relevant functions to reach the desired endpoint. This means that pyaesa automatically runs upstream computations needed to produce that endpoint, i.e., to ensure that all previous outputs are available before running the downstream function providing the endpoint. The user hence only needs to focus on what is the study objective of interest, and run the relevant function.

For instance:

For B.2 study objectives (i.e., aCC endpoints), the final entry function can auto run pyaesa owned deterministic aSoCC and dynamic AR6 CC outputs when needed.
For C study objectives (i.e., ASR endpoints) with pyaesa owned IO-LCA, the final entry function can auto run pyaesa owned aCC and IO-LCA outputs when needed.
For ASR with external aSoCC or external LCA, prepare_external_inputs(...) creates the external input folders, and users must stage the external files before the ASR call.

Choose the study objective (i.e., the endpoint) and call the corresponding deterministic or uncertainty function directly.\

Study objective	Final entry function	Reference notebooks
(A) IO-LCA results	`deterministic_io_lca(...)` `uncertainty_io_lca(...)`	Deterministic IO-LCA tutorial Uncertainty IO-LCA tutorial
(B.0) Dynamic AR6 climate change CC	`deterministic_ar6_cc(...)` `uncertainty_ar6_cc(...)`	Deterministic dynamic AR6 CC tutorial Uncertainty dynamic AR6 CC tutorial
(B.1) aSoCC results	`deterministic_asocc(...)` `uncertainty_asocc(...)`	Deterministic aSoCC tutorial Uncertainty aSoCC tutorial
(B.2) aCC results	`deterministic_acc(...)` `uncertainty_acc(...)`	Deterministic aCC tutorial Uncertainty aCC tutorial
(C) ASR results with pyaesa owned IO-LCA	`deterministic_asr(...)` `uncertainty_asr(...)`	Deterministic ASR tutorial Uncertainty ASR tutorial
(C) ASR results with external aSoCC or external LCA	`deterministic_asr(...)` `uncertainty_asr(...)`	External input staging tutorial Deterministic ASR tutorial Uncertainty ASR tutorial

What to do next

Check out tutorials/study_objectives/1_functional_units_and_allocation_methods.md before discovering the notebooks provided for each study objective available in pyaesa.