Installing Tropofy on a Windows System

Tropofy is known to run on all popular UNIX-like systems such as Linux, MacOS X, and FreeBSD, as well as on Windows platforms. Tropofy requires Python version 2.7 to run, and does not require the compilation of any C code, so you need only a Python interpreter that meets the requirements mentioned.

Installing Python

If your Windows system doesn’t have a Python interpreter, you’ll need to follow the below instructions to install it:

  1. Install, or find Python 2.7 for your system. See most popular direct download links below:
  2. Once you’ve downloaded it, double click on the .msi file, and accept the defaults during the installation process.
  3. Next, you may also need to download and install the Python for Windows extensions. See most popular direct download links below:
  4. Once you’ve downloaded it, double click on the executable file, and install it using the same Python installation from step 1.

Warning

After you install Python on Windows, you will need to add the C:\Python27 directory to your environment’s Path in order to make it possible to invoke Python from a command prompt by typing python. For Windows 7, right click My Computer, select Properties from the context menu –> Advanced system setttings from the left hand menu –> Advanced Tab from the dialog box –> Environment Variables button in the bottom left and add that directory to the end of the Path environment variable listed in the system variables section by double clicking and appending ;C:\Python27 to the end.

Set Up a Python Virtual Environment

It is best practice to install Tropofy into a “virtual” Python environment in order to obtain isolation from any “system” packages you’ve got installed in your Python version. This can be done by using virtualenv. The steps required to setup a Python virtual environment are described below,

  1. Ensure Python 2.7 is installed (see above)

  2. Install the latest setuptools distribution into the Python you obtained/installed/found above:

    • Download ez_setup.py (right click this link -> save target as / save as -> save locally to c:\ez_setup.py)

    • Open a command prompt and navigate to the location of the downloaded ez_setup.py, and then run it.

      cd c:\
      
    • Run ez_setup.py using a command prompt:

      c:\> Python27\python ez_setup.py
      
  3. Use that Python’s easy_install to install virtualenv:

    c:\> Python27\Scripts\easy_install virtualenv
    

    Note

    (6th Jan 14): The latest release of virtualenv may throw an AssertionError here. To fix this run:

    c:\> Python27\Scripts\easy_install "setuptools=2.0.2"
    c:\> Python27\Scripts\easy_install pip
    c:\> Python27\Scripts\pip install virtualenv
    
  4. Use that Python’s virtualenv to make a workspace:

    c:\> Python27\Scripts\virtualenv --no-site-packages tropofy_env
    
  5. Set your command prompt to use the virtual environment tropofy_env :

    c:\> tropofy_env\Scripts\activate
    

Installing Tropofy

  1. Use pip to get Tropofy and its direct dependencies installed:

    (tropofy_env) c:\> pip install tropofy
    

    Note

    Tropofy is dependent on pandas which for some Windows installations fails when installed via pip. If you experience the error distutils.errors.DistutilsError: Setup script exited with error: Unable to find vcvarsall.bat, run the following commands then try installing Tropofy via pip again: :

    (tropofy_env) c:\> pip install wheel
    

    Download the wheel file (.whl) for the required version of pandas. Wheels for the most recent version of pandas are available from the pandas pypi site. Navigate to the directory where you saved the file and install pandas:

    (tropofy_env) c:\> pip install PANDAS_WHEEL_FILE_NAME.whl
    

    Note that PANDAS_WHEEL_FILE_NAME.whl should be replaced with the name of the pandas wheel file you downloaded. Now try installing Tropofy again:

    (tropofy_env) c:\> pip install tropofy
    

You’re now ready to start Running and Debugging your Tropofy app!

Note

Trouble with installation?

  1. Run pip install tropofy again. Sometimes Pip can be unresponsive for certain packages. Usually trying the installation again will fix the problem.

  2. Are you behind a proxy? In most corporate environments you will access the internet through a proxy. This may interfere with Pip. Use the –proxy command with Pip to get around this (you may have to contact your IT department to get proxy details and authentication info).

    (tropofy_env) c:\> pip install --proxy=https://proxyAddress:proxyPort tropofy
    
  3. If problems persist, contact us at info@tropofy.com.