development of the paper.md file

paper.md

@@ -36,21 +36,21 @@ The international scientific community assessing on climate change and mitigatio
     - ensure full transparency about the origin and structure of data.
 	- facilitate the comparison across models in both the historical period and future scenarios.
 	- discuss on conceptual ideas about the internal structure of models, so to what extent different models representing 
-	  the same system deliver different results. 
+	  the same system deliver different results.
 
-Results from different measurement procedures for the same measure should be equivalent (harmonized) within stated specifications to measure uncertainty. A task that is already mandatory to contribute on high-level international reports such as those elaborated by the Intergovernmental Pannel of Climate Change (IPCC) while necessary in the daily work of collaborative projects where different tools are applied to solve the same research question. The present `wiliamcformat` library aims to adapt and extend the potential of existing material for users of a novel integrated assessment model, WILIAM. A pending task that has not been documented before although the urgency for improving transparency and responsability of this model to meet open-science principles (FAIR [@Wilkinson2016] and TRUST [@Lin2020]), as well as usability. Furthermore, we hope the contents will help to move students closer to climate change science.
+Results from different measurement procedures for the same measure should be equivalent (harmonized) within stated specifications to measure uncertainty. A task that is already mandatory to contribute on high-level international reports such as those elaborated by the Intergovernmental Pannel of Climate Change (IPCC) while necessary in the daily work of collaborative projects where different tools are applied to solve the same research question. The present `wiliamcformat` library aims to adapt and extend the potential of existing material for users of a novel integrated assessment model, WILIAM. A pending task that has not been documented before although the urgency for improving transparency and responsability of this model to meet open-science principles (FAIR [@Wilkinson2016] and TRUST [@Lin2020]), as well as usability. Furthermore, we hope that these materials will inspire students to engage move deeply with the science of climate change and social transitions.
 
 
 # Statement of need
 Integrated assessment models (IAMs) have been used for a wide range of problems in the climate change field. From generating consensus to identify key parameters and complex feedbacks on future between the world economies and nature [@Sarofim2011]. However, [@Wilson2021] highlight that IAM evaluation should improve interpretability of results to communicate insights, credibility as producers of knowledge under a 'sceptical review', and relevance of modelling analysis for informing scientific understanding to policymakers and stakeholders. A challenge that may be achieved (at least partially) with model inter-comparisons, which are mostly used to compare outputs and insights to explore uncertainties, and diagnostics, which proposes descriptive indicators to explain characteristics of the performance in terms of model structure and assumptions.
 
 The demand from model inter-comparison projects (MIPs) is a fruitful enterprise [@EdNature2015]. Recently, [@Nikas2021] identified several MIPs and inter-comparison studies. An emerging practice in the field of IAMs that will surely place these tools at the same level of reliability than climate and energy models. To overcome the limitations, the IAM Consortium and the International Institute for Applied Systems Analysis (IIASA) started with a common standard, the IAMC format [@IAMCformatIIASA] and a plotting module to play with timeseries called *pyam* [@Huppmann2021]. Some prominent studies using the IAMC format have been recently mentioned by [@Claudia2024] including IPCC reports and milti-IAM studies.
 
-Additionally, despite the importance of climate change education[^1] in responding to the impacts of climate change, [@Filho2023] identified *less attention given to systematically assessing the attitude, perceptions, and practices of students and the integration *of the climate topic in the higher education institutions’ curricula and co-curricular activities in a way that may guide changes in the curriculum and teaching practices*. Consequently, we also aim to contribute to education, bring students closer to the climate change problems through playing with the present code in Python lessons. For example, the University of Valladolid currently has Python as mandatory subject in the official courses of sciences and engineering. 
+Additionally, despite the importance of climate change education[^1] in responding to the impacts of climate change, [@Filho2023] identified *less attention given to systematically assessing the attitude, perceptions, and practices of students and the integration of the climate topic in the higher education institutions’ curricula and co-curricular activities in a way that may guide changes in the curriculum and teaching practices*. Consequently, we also aim to contribute here, inspiring students to engage with climate change problems through the present code in Python lessons. 
 
 [^1] Climate change education refers to curricular contents deployed to increase awareness on climate change [@Filho2023].
 
-We have replicated the structure proposed by [@Claudia2024] for explaining the contents because of proximity of GCAM and WILIAM (both are IAMs) and shared inter-comparison experience in the project called IAM COMPACT (see acknowledgements). It is helpful to also compare and develop similarities of both tools.
+We have followerd the structure proposed by [@Claudia2024] for explaining the materials because of the proximity of GCAM and WILIAM (both are IAMs) and the shared inter-comparison experience in the project called IAM COMPACT (see acknowledgements). 
 
 WILIAM is a nascent system dynamics policy-simulation model, descendent from the MEDEAS model [@capellan2020], which purpose is to capture the socioeconomic implications of the energy transition(s) accounting for biophysical constraints. Although there are some articles published, standardization and harmonization is yet missing so a potential improvement to better present results and increase the transparency of the overall research activity with it. To do it properly, we have developed `wiliamcformat`, a python package that translates WILIAM outputs to IAMC format timeseries for linking results with the existing aPython library called pyam, supported by IIASA. Standarization, harmonization and visualization in a unique code for WILIAM users.
 
@@ -59,6 +59,20 @@ This section describes the code with a short example to easily follow the whole
 
 ## A brief description
 
+The `wiliamcformat` package is public, available at the domain https://github.com/Tristan22400/IAMC_format. Following the next steps (more detailed in the *README.md* file), the user can obtain the results of WILIAM under the IAMC format criteria and plot results in a general report or customized graphs.
+
+The user can generate a specific environment to install (via pip) all the required packages. Once all packages are installed, the user only needs to follow the next steps:
+
+1. Download the package and unzip it.
+2. Open the terminal and go to the folder containing the package.
+3. (optional) We recommend the creation of a virtual environment to avoid uncompatible dependencies across Python packages with new updates. To do it, the easiest way is to open the anaconda prompt and run `conda create --name wiliamcformat`. You can check the available environments in your computer by typing `conda env list`, and activate it through `conda activate wiliamcformat`.
+3. Run `pip install -r requirements.txt --user` to install all the dependencies required automatically.
+2. Place the files with the WILIAM results (CSV files) into the folder *File_To_Convert*. *Baseline no policies no CO2tax.csv* is a real simulation of WILIAM with results with which anyone can play. 
+3. Execute the file *Convert_Wiliam_result_IAMC-format.py* to translate the results under IAMC format criteria. The script converts all the existing CSV files in the folder (`python Convert_Wiliam_result_IAMC-format.py`).
+4. Finally, run the *merge_csv* to merge all files present in the folder *File_Converted* (`python Merge_csv.py`)
+
+There are several notebooks available in the folder *Visualization* to facilitate the learning process, including a general report with principal variables of the model, as well as specific examples of customizable plots.
+
 ## Notes about the architecture
 
 # Acknowledgements