Instructions for Updating Source Data Files

If you are adding new agreements:

(1) Load the latest CSV file exported from the Peace Agreements Database (PA-X) into PA-X_dataAnalysis.ipynb (the Jupyter notebook under pax/timeline/data) to generate a CSV file that only includes the columns of data relevant to the visualization:

• AgtId - unique identifier for the agreement
• Agt - name of the agreement
• Con - country or entity names of the agreement
• Dat - date of the agreement, format DD/MM/YYY
• Year - four digit year from the date of the agreement
• Agtp - agreement type (values are strings)
• Stage - agreement stage (values are strings)
• StageSub - agreement substages (values are strings; visualizations only use "FrCons")
• HrFra - the substantive code 'Human Rights Framework' (values are numbers)
• Pol - the substantive code 'Political Institutions' (values are numbers)
• Eps - the substantive code 'Economic Power Sharing' (values are numbers)
• Mps - the substantive code 'Military Power Sharing' (values are numbers)
• Polps - the substantive code 'Political Power Sharing' (values are numbers)
• Terps - the substantive code 'Territorial Power Sharing' (values are numbers)
• TjMech - the substantive code 'Transitional Justice Past Mechanism' (values are numbers)
• GeWom - the substantive code 'Women, Girls and Gender (values are numbers)

If you are adding new agreements between 1 January 1990 through 31 December 2015 that do not have new countries or entities:

(1) Use PA-X_dataAnalysis.ipynb (the Jupyter notebook under pax/timeline/data) to generate a new JSON file for the map data source file

(2) Change the data source file in pax/map/index.html to the name of the JSON file you generated in step 1

(3) Change the data source file in pax/timeline/timeline-chronology.js, -datCounts.js, -yearly.js, -proportions.js, -verticalA.js, -verticalB.js, and -verticalC.js

If you are adding new agreements that have new countries or entities:

(1) Find the latitude and longitude coordinates of each new country or entity

(2) Use PA-X_dataAnalysis.ipynb (the Jupyter notebook under pax/timeline/data) to generate a new JSON file that includes the latitude and longitude for each new agreement in the "coordinates" object of the map data

(3) Change the data source file in pax/map/index.html to the name of the JSON file you generated in step 1

(4) Use PA-X_dataAnalysis.ipynb (the Jupyter notebook under pax/timeline/data) to generate a new CSV file of conTags to use for the dropdown lists of country/entity names for the top selecter (select.html) and for the three vertical timelines (index-t-verticalA.html, -verticalB.html, -verticalC.html)

If you are adding new agreements that were signed before 1 January 1990 or after 31 December 2015:

(1) Use PA-X_dataAnalysis.ipynb (the Jupyter notebook under pax/timeline/data) to generate a new file of startYearTags.csv and endYearTags.csv as necessary for the top selecter (select.html)

(2) Update the minimum and maximum dates set in select.js ("paxNewMinDay" and "paxNewMaxDay"), and update the "title" string of PNG exports with the new minimum and maximum dates in timeline-verticalA.js, -verticalB.js, and verticalC.js

---

Note: The timelines’ axes, the count and proportion calculations, and the size of the timeline visualizations are determined by the data source file, so those will adjust to new data automatically.