Methodological Notes
====================

This page provides the methodological notes and citation guide shipped with the
package and copied by ``set_workspace(...)`` into
``data_raw/methodological_notes/``.

The methodological notes comprise the article and its appendices:

* `UNCASExt arXiv preprint <https://arxiv.org/abs/2606.21465>`__:
  article providing the methodological basis for ``pyaesa``.
* :download:`Appendix B: functional units, allocation methods, prospective allocation, and uncertainty sources <../methodological_notes/appendixB_UNCASExt_Allocating_Shares_of_Carrying_Capacities.pdf>`
* :download:`Appendix C: carrying capacities definition <../methodological_notes/appendixC_UNCASExt_Carrying_capacities_definition.pdf>`

Citation
--------

Please cite these references when using ``pyaesa``, as they constitute the
methodological basis for ``pyaesa``, including the allocation methods included
in the package.

de Bantel, E. I., Pirson, T., Puig-Samper, G., Hartmann, J. M., Bol, D.,
Bouillass, G., Yannou, B., Jankovic, M., & Hauschild, M. Z. (2026).
UNCASExt: A systematic computational framework for uncertainty propagation and
scope consistency in absolute environmental sustainability assessments (AESA)
[Preprint]. arXiv. https://arxiv.org/abs/2606.21465

Pirson, T., de Bantel, E. I., Puig-Samper, G., Hartmann, J. M., von der
Assen, N., Owsianiak, M., Clavreul, J., Bouillass, G., Yannou, B.,
Jankovic, M., & Bol, D. (2026, May 17-21). PyUNCASE: Towards a Python package
for systematically allocating carrying capacities under uncertainty in AESA
[Conference abstract]. SETAC Europe 36th Annual Meeting, Maastricht,
Netherlands. SETAC.
https://setac.confex.com/setac/europe2026/meetingapp.cgi/Paper/32699

Additional Citations
--------------------

For data source citations, see the recommended citation guide:

* :download:`Recommended citations <../methodological_notes/recommended_citations.txt>`

Functional Unit Guide
---------------------

* :doc:`tutorials/study_objectives/1_functional_units_and_allocation_methods.md <tutorials/study_objectives/1_functional_units_and_allocation_methods>`:
  short guide summarizing Appendix B regarding the selection of functional units and allocation methods in ``pyaesa``.