This repository may be downloaded by using a command line interface:
1. installing osfclient
- `conda install osfclient`
- or `pip install osfclient`
2. cloning `osf -p 2wf6g clone`
All data analysis and representation was accomplished using `Python 3.6.5` with a single script `figures.py`. We use a library called `WrightTools` to aid in data import and representation. In order to execute `figures.py`, `WrightTools` should be installed. This can be accomplished with `conda` or `pip`.
- `conda install WrightTools=3.1.3`
- `pip install WrightTools==3.1.3`
in which the version of `WrightTools` that was used in the workup is installed (newer versions are available).
The entire project (excluding simulation fitting) may be built by simply running `python build.py` in a command line. `build.py` will generate a new `wt5` files (our implementation of the excellent `hdf5` data format) and then read the data from the `wt5` files to make figures.
Simulation fitting takes ~50 hrs and may be accomplished by running the `.py` files present in the `simulation` directory. Note, these simulations could likely be optimized significantly by rewriting the code for the non-general case.
## Instructions for figure generation
In order to run our figure generation script, the following ought to be accomplished:
0. Obtain [`Python 3.6`](www.python.org) or later. (see Note 1 at bottom)
1. Obtain the [SciPy software stack](www.scipy.org/install.html). (see Note 1 at bottom)
2. Obtain `WrightTools`. The easiest ways to get the current stable version is to use pip or conda from your command line. `pip install wrighttools` or `conda install wrighttools`. (see Note 2 at bottom)
3. Run the `figures.py` script.
## Notes
1. We find it easiest to use the excellent, free [Anaconda distribution](www.continuum.io/downloads) to get Python and the SciPy stack on our machines.
2. Alternatively, you can clone from [GitHub](github.com/wright-group/WrightTools) and ensure that it is located in your PYTHONPATH. This folder should be downloaded and then the user should run `python setup.py install` while in the same directory as the WrightTools `setup.py` script.
3. If additional aid or description is needed, don't hesitate to email Darien Morrow at darienmorrow@gmail.com (permanent) or dmorrow3@wisc.edu (current institution).