TUFLOW FV Python Environment

From TUFLOW FV Wiki
Jump to navigation Jump to search

This page walks you through the setup of the TUFLOW FV Python Toolbox (tfv) environment using minconda and conda forge.

Miniconda Installation

1. Install Miniconda. Note: Ensure you install Miniconda. Do not substitute it for a new, or already installed Anaconda distribution package.

Miniconda Download Button.png
  • Complete the email form to be sent a download link.
Miniconda Register.PNG
  • You should receive an email similar to this below.
Miniconda Email.PNG
  • You should then be taken to a list of Anaconda and Miniconda installer options. The installer download should look similar to the below image although the version may differ. Ensure that Miniconda for Windows is selected.

Conda install 1.png

2. Once downloaded, install and follow the prompts. Select the default options as you are guided through the install wizard.

Prepare TUFLOW FV Working Environment

In this environment we will install the tfv Python package and the modules required to complete common post-processing tasks on TUFLOW FV results.

To open Anaconda Prompt by typing "anaconda prompt" into the Windows Search Bar:

Anaconda prompt search.png


When you open Anaconda Prompt, confirm it's been installed via the miniconda installation by checking this message at the top of the console window:

Miniconda Message.PNG


After a few moments the the console window should change and appear similar to the below:

Anaconda prompt console window.png


1. Copy the file tfv_workspace.yaml from the download package into your C:\Users\MyUser\ folder where MyUser is your specific user name.


2. Run the command: conda env create --file=tfv_workspace.yaml as show below:

Conda env create.png


3. Hit enter. The installation may take a few minutes to complete. Once completed the prompt should look similar to the following:

Conda env install.png

4. Activate the tfv-workspace environment by entering the command: conda activate tfv-workspace as shown below:

Conda env activate.png

Note that when you activate the workspace you will move from the base environment to the tfv-workspace environment as show below:

:Conda workspaces.png

Conclusion

You have now installed the TUFLOW FV Python Toolbox, including the TUFLOW FV Get Tide, TUFLOW FV Get Atmos and TUFLOW FV Get Ocean tools.

Return to the TUFLOW FV Python Toolbox Page.