installation

The software and program files necessary to run the seniority_list program are free to download and use.

dependencies

Python 3*

Python libraries

bokeh *

bottleneck *

Ipython *

matplotlib *

numba *

numexpr *

NumPy *

openpyxl *

pandas *

python dateutil *

SciPy *

seaborn *

xlrd *

xlsxwriter *

xlwt *

Jupyter notebook*

* included with anaconda

seniority_list is designed to use the Jupyter Notebook (notebook) as its user interface. The notebook is required to run the interactive editor.

The name “Jupyter” is a loose acronym referring to the Julia, Python, and R programming languages. The notebook supports these and many other languages.

Information concerning the Jupyter notebook may be found here. There are numerous guides and tutorial videos online as well. Specific details pertaining to notebook usage with seniority_list are located in the “user guide” section.

spreadsheet program

A spreadsheet program compatible with .xlsx files is required to handle the input data and to read output from the program. Microsoft Excel® may be used with seniority_list, but is not required. LibreOffice Calc is an open-source spreadsheet program which works well with seniority_list. LibreOffice is free and may be downloaded here.

installing Python and Python libraries

Your computer must have the Python program and the associated Python libraries (helper programs which perform specialized tasks) as listed above on your computer to be able to run seniority_list. Nearly all of these requirements are met with one download and installation of the Anaconda scientific platform. Navigate to this webpage and select the Python 3.6 (or above) and 64-bit version appropriate for your operating system. Install, using the default prompts. Detailed installation instructions are found here, if needed.

Note: The anaconda download is 350-600mb depending on your operating system and will require approximately 3gb of disk space when it is installed.

At this point, the Python program files necessary to run seniority_list have been installed. The next step is to download and install the actual seniority_list program.

installing seniority_list

The seniority_list program and sample data files are downloadable from a GitHub repository. GitHub is a widely used hosting service for open source software projects. A repository is a container which holds code and other files relating to a project. The repository address for seniority_list is:

https://github.com/rubydatasystems/seniority_list.git

The easiest way to obtain the seniority_list program files from GitHub is to install the git program, which has a built-in method to grab files from GitHub repositories with one command line input.

git may be installed through the Anaconda platform. To install git, type or copy and paste the following command into a terminal:

conda install git

Once git is installed, open a terminal and type or copy and paste the following command:

git clone https://github.com/rubydatasystems/seniority_list.git

The git program will retrieve and install all of the program and sample data files from the GitHub repository (< 15mb).

Note

When running seniority_list with a Windows operating system, references to the terminal apply to the Anaconda Prompt, opened from the Start Menu. Linux and MacOS users may use the standard terminal prompt.