# Install PoPy

## Downloading PoPy

First, download the latest binary from:-

https://product.popypkpd.com/releases/

To access the url above you need to Obtain a website account for the PoPy product site, then login using your email address and a password.

We currently provide a 64-bit version of PoPy for Windows 7/8/10. The download file is approximately 250Mb which will take around 5 minutes to download using a broadband connection.

Note

If you have a previous version of PoPy installed, please Uninstall PoPy before installing the new version.

## Installing PoPy

Double-click on the PoPy installer:-

    popy-1.1.1-win64-installer.exe

The installer places the software in a subdirectory called ‘PoPy’. We recommend PoPy is installed in the root directory of the main drive, typically:-

    c:\PoPy

A local user typically has write access to the c:\ drive but not to c:\Program Files unless the user is an administrator.

The installer will uncompress the PoPy files, just click on the .exe installer and follow the prompts. You will need approx 1.5Gb of disk space, and the install time may take 5 minutes or so depending on the speed of your computer.

The installer also creates a desktop shortcut and Windows start menu shortcut under the name ‘PoPy’, for the current user only.

The installer makes no changes to the Windows registry and does not require admin rights.

Note

It is possible to install PoPy on a usb stick. However due to the way the Python language operates, i.e. many .py files, this will have a significant performance impact. It is much better to install PoPy on the main hard drive of a computer.

### Multi User Installation

The installer sets up PoPy for the current user only. To share a PoPy installation with another user, simply add the PoPy directory to their system path, so they can access the ‘popy_env.bat’ batch file. Windows start menu shortcuts can also be created manually, if desired.

## Checking your new PoPy Installation

PoPy runs from the command line, typically called command prompt under Windows 7-9 or PowerShell under Windows 10. To access PoPy commands in the current command prompt, type:-

    $ popy_env

This scripts sets up the environment variables so you can access PoPy commands. See Open a PoPy Command Prompt.

To verify that PoPy is installed, execute the command:-

    $ popy_info

If PoPy has successfully installed, output similar to that below will appear, providing detailed information on the installation:-

    INFO - In a PoPy Binary environment
    INFO - popy_flavour=binary
    INFO - popy_python_path=C:\PoPy\
    INFO - popy_release=1.1.1
    INFO - popy_version=academic
    INFO - python_version=3.8.6
    INFO - windows_version=('10', '10.0.17134', 'SP0', 'Multiprocessor Free')
    INFO - machine_name=saruman
    INFO - product_key=None
    The product is running in trial mode
    trial days remaining=3
    INFO - should_run=True

The output above will vary depending on the PoPy Activation status of PoPy.

If you want to run more rigorous tests then see Validate PoPy.

## Win10 Increase max path length

Note if you use PoPy with deeply nested folder structures it is recommended that you increase the max file path length from the default Windows 10 limit of 260 characters, see here:-

https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation

For your convenience we have supplied the following registry editor file:-

    conf/win10_allow_long_paths.reg

If you are using Windows 10 and have admin privileges, you can simply click on this file to remove the 260 character limit. Unfortunately this registry edit does not work on Windows 7.

## Troubleshooting

If you have any problems with this installation process, and cannot find the answer on the Troubleshooting page, then email us at info@popypkpd.com.

## First Steps after Install

Congratulations, you have installed PoPy on your machine and can now begin to use this powerful population modelling software immediately.

To setup tabs correctly on your editor see Configure Editor.

See Fitting a Simple PopPK Model using PoPy for a walk through of a simple fitting example.