This readme.txt file was generated for the dataset "Sanitation technology assessment and system option generation" on [30.11.2017] by Dorothee Spuhler at Eawag (Swiss Federal Institute of Aquatic Science and Technology)

The data are made available under the Public Domain Dedication CC0 1.0 Universal (https://creativecommons.org/publicdomain/zero/1.0/legalcode). To the extent possible under law, Dorothee Spuhler and Eawag have waived all copyright and related or neighbouring rights to this work.

If you use data or software in this package please cite both, this data package and the associated publication:


-------------------
RECOMMENDED CITATION
-------------------

1. Associated publication: Spuhler, D., Scheidegger, A., and Maurer, M. (2018), Generation of sanitation system options for urban planning considering novel technologies. Submitted to Water Research.

2. This data: Spuhler, D. (2018), Data for: Spuhler, D., Scheidegger, A., and Maurer, M. (2018), Generation of sanitation system options for urban planning considering novel technologies. Submitted to Water Research.


-------------------
GENERAL INFORMATION
-------------------


1. Title of Dataset: Sanitation technology assessment and system option generation


2. Author Information

  Principal Investigator Contact Information
        Name: Dorothee Spuhler
          Institution:  Eawag
          Email: dorothee.spuhler@eawag.ch

  Alternate Contact Information
        Name: Max Maurer
          Institution:  Eawag
          Email: max.maurer@eawag.ch
        Name: Andreas Scheidegger
          Institution:  Eawag
          Email: andreas.scheidegger@eawag.ch


3. Purpose: This data has been used (1) to quantify the appropriateness of a set of sanitation technologies for a small town (Katarnyia) in Nepal and (2) to generate sanitation system options from the appropriate technologies as an input into strategic sanitation planning using a structured decision making process. For (1), the appropriateness is quantified based on a set of criteria, also called screening criteria. These criteria include technical, socio-demographic, climatic, and institutional aspects and are quantified using uncertainty functions in order to account for the quality and quantity of available input information.


4. The data contains raw data as well as modelling results.
The raw data is a compilation of information collected from literature, information collected through a household survey in the small town, field observations. They are all used to describe the screening criteria for the studied sanitation technologies and the small town.
Results include: (1) the outcome of the technology appropriateness assessment (technology appropriateness scores); and (2) the sanitation system options (all possible sanitation systems built from the appropriate technologies, and a smaller set of divers and highly appropriate sanitation system options as an input into decision-making).


--------------------------
RELATED MODELS
--------------------------


1. The model for the technology appropriateness assessment (TechAppA) is available here: https://github.com/Eawag-SWW/TechAppA.git (Release v1.0). The associated github repository is also available in this data package (TechAppA.jl-1.0.tar.gz).


2. The model to generate sanitation systems and to identify a set of decision options (SanintationSystemBuilder): is available here: https://github.com/Eawag-SWW/SanitationSystemBuilder.jl (Release v1.0). The associated github repository is also available in this data package (SanitationSystemBuilder.jl-1.0.tar.gz).


3. License placed on the models: GNU General Public License, see http://www.gnu.org/licenses/



---------------------
DATA AND FILE OVERVIEW
---------------------


1. Folder 1_techappa

descirption_of_screening_attributes.pdf
- detailed description of screening criteria and corresponding attributes intended to support raw data collection

user_guidelines.pdf
- guidelines on how to use the model for technology appropriateness assessment.

input
- folder with model input files techdata.csv and casedata.csv
-- casedata_katarniya.csv: uncertainty model parameters for the application case (AppCase) attributes
-- techdata_katarniya_....csv: uncertainty model parameters for the technology option (Tech) attributes for run 01 to run 4 (see linked publication for more information).

output
- folder with model outputs
-- techappframe_katarnyia_ds....csv: results of the appropriateness assessment for run 01 to run 04. Run 1 corresponds to the baseline, the other runs were used for the sensitivity analysis (see associated publication for more information).
-- techappframe_katarnyia_ds-compilation.xlsx: summary of all results.


2. Folder 2_sanitationsystembuilder

input
- folder with model input files containing the Tech descriptions and the technology appropriateness score (TAS) resulting from model 1.

output
- folder with all model outputs from rom run 2-1 to 2-7. Run 2-1 is the baseline and run 2-2 to 2-7 are used for the sensitivity analysis.
-- allsystems_properties_compilationallruns.xlsx: overview on the results for all runs. The results include the system properties. Systems that were selected to feed into decision-making are highlighted.
-- katarniya_systems.jld:  contains all generated sanitation systems and their properties for run 2-1. This is a Julia data file used internally by the SanitationSystemBuilder and is therefore not documented.
-- katarnyia_selectedsystems_run...pdf: graphical representation of the selected set of sanitation systems.
-- katarniya_allsystems_...pdf: graphical representation of the all sanitation systems grouped by source.


3. Relationship between the folders: The input for both models is the same: a set of technologies and corresponding characteristics. The technology appropriateness from the TechAppA model are used to quantify the system appropriateness score (SAS) in the SanitationSystemBuilder.
