Information

This repository houses the LaTeX and Python source files to build the paper:

Jason K. Moore, Bryn Cloud, Mont Hubbard, and Christopher A. Brown, "Safety-Conscious Design of Terrain Park Jumps: Ethical Issues and Online Software", 2021

Preprint available at https://doi.org/10.31224/osf.io/sq7u9

The contents of this repository, unless otherwise specified in the file, are licensed under the Creative Commons Attribution 4.0 license. See LICENSE.

Building the paper

Install git, make, and conda. Install a TeX distribution, e.g. texlive, and make sure the directly used packages are installed: nameref, hyperref, asmmath, amssymb, siunitx, graphicx, todonotes, bibtex, and minted.

Clone the paper and the skijumpdesign repositories:

$ git clone [email protected]:mechmotum/ski-jump-analysis-paper.git
$ cd ski-jump-analysis-paper

Create a conda environment for this project:

$ conda env create -f environment.yml

This environment.yml pins the primary software dependencies to the exact versions used to create the published paper.

Activate the environment:

$ conda activate ski-analysis-paper

Build the paper:

(ski-analysis-paper)$ make

The figures are generated by the following command inside the Makefile if needed separately:

(ski-analysis-paper)$ python src/case_study_figures.py

Updating the References

This Zotero collection is being used to generated the bib file:

https://www.zotero.org/groups/966974/mechmotum/collections/D3MHJZ2G

The Better BibTex Zotero plugin is used to generate the bib file and the citation keys using [Auth][Year]:

https://github.com/retorquere/zotero-better-bibtex

Setup

1. Install Zotero.
2. Install the Zotero connector for your web browser: https://www.zotero.org/download/connectors
3. Open Zotero (application on your computer).
4. Setup syncing in the Zotero preferences by providing your zotero username and password (create an account if needed and inform Jason of your username).
5. Install the zotero-better-bibtex plugin by following these directions: https://retorque.re/zotero-better-bibtex/installation/
6. Restart Zotero
7. In the Zotero menu open the Edit>Preferences and click the "Better BibTex" button. Change the citation key format to [auth][year] and close the preferences window.
8. Select the "Ski Jump EFH Analysis" folder.
9. Highlight (select) all the items in the folder and right click. Select the Better BibTeX > Refresh BibTeX key to set all the citekeys to the new format.

Adding new references

1. Open Zotero and select the "Ski Jump EFH Analysis" folder in the left column.
2. Open your web browser and navigate to a journal article web page.
3. Press the "Save to Zotero" button in the upper right (just to right of url bar). The article (and pdf) should show up in Zotero.

See these instructions if more info is needed: https://www.zotero.org/support/adding_items_to_zotero

Updating the .bib file on Overleaf

1. In Zotero, right click the "Ski Jump EFH Analysis" folder and select "Export collection".
2. Set the Format to "Better BibTeX" and press "OK".
3. Save the .bib file somewhere as references.bib.
4. In Overleaf, remove the references.bib file and upload your new one. Optionally, you can open the file on your computer, copy all the text and paste over all the text in the bib file on Overleaf.