Quick Start Guide

These instructions will help you get up and running with PyChOpMarg quickly. It is generally advisable to work within a virtual environment when installing a non-standard package, such as PyChOpMarg. And these instructions will guide you down that path. This will protect your existing system Python installation from any incompatibilities between it and PyChOpMarg and/or its dependencies.

Installation

To install PyChOpMarg into a dedicated new virtual environment, execute these commands from an appropriate shell prompt:

  1. python3 -m venv ~/.venv/pychopmarg

    • This command creates the new dedicated Python virtual environment.

    • I’ve assumed that you keep your Python virtual environments in the .venv/ sub-directory of your home directory. If that’s not the case then you’ll need to modify the command slightly, to accommodate your system layout and usage habbits.

  2. source ~/.venv/pychopmarg/bin/activate

    • This command activates the new virtual environment, so we can install packages into it.

    • Windows users should use the command: . ~/.venv/pychopmarg/Scripts/activate

    • You’ll know that you have correctly activated your new virtual environment when you see the text “(pychopmarg)” appear above your prompt.

  3. pip install pychopmarg

    • This command installs PyChOpMarg and its dependencies into your new virtual environment.

Launching the GUI

Note: The GUI is not currently working.

To launch the PyChOpMarg GUI application, simply type: pychopmarg and hit <RETURN>.