|
|
@ -10,10 +10,10 @@ Prerequisites |
|
|
|
--------------- |
|
|
|
--------------- |
|
|
|
|
|
|
|
|
|
|
|
This tutorial assumes that you have basic knowledge of how to type commands |
|
|
|
This tutorial assumes that you have basic knowledge of how to type commands |
|
|
|
in to a command terminal using your preferred operating system. The student |
|
|
|
in to a command terminal using your preferred operating system. You |
|
|
|
should know some basic directory commands like *cd*, *mkdir*, *cp*, *mv*. |
|
|
|
should know some basic directory commands like *cd*, *mkdir*, *cp*, *mv*. |
|
|
|
|
|
|
|
|
|
|
|
Regarding Python, to understand the examples in this tutorial, the student |
|
|
|
Regarding Python, to understand the examples in this tutorial, you |
|
|
|
should have some experience with Python basics. This includes: |
|
|
|
should have some experience with Python basics. This includes: |
|
|
|
|
|
|
|
|
|
|
|
- Opening a Python interpreter and entering commands. |
|
|
|
- Opening a Python interpreter and entering commands. |
|
|
@ -28,7 +28,7 @@ should have some experience with Python basics. This includes: |
|
|
|
- Familiarity with matplotlib would be helpful, as only a very brief |
|
|
|
- Familiarity with matplotlib would be helpful, as only a very brief |
|
|
|
introduction is provided. |
|
|
|
introduction is provided. |
|
|
|
|
|
|
|
|
|
|
|
If a student is completely new to Python, that shouldn't be a problem, since |
|
|
|
If you are completely new to Python, that shouldn't be a problem, since |
|
|
|
most of the examples consist of basic container types and function calls. It |
|
|
|
most of the examples consist of basic container types and function calls. It |
|
|
|
would be helpful to look at some introductory material before arriving at the |
|
|
|
would be helpful to look at some introductory material before arriving at the |
|
|
|
tutorial. If you've programmed before, picking up Python is fairly easy. |
|
|
|
tutorial. If you've programmed before, picking up Python is fairly easy. |
|
|
@ -77,6 +77,23 @@ going to use Python 2.7, but it should also work with Python 3.5+. However, |
|
|
|
due to limitations with open source compilers on conda-forge, only Python 2.7 |
|
|
|
due to limitations with open source compilers on conda-forge, only Python 2.7 |
|
|
|
is available for Windows. |
|
|
|
is available for Windows. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Please use the appropriate link below to download Miniconda for your operating |
|
|
|
|
|
|
|
system. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. note:: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
64-bit OS recommended |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Win64 <https://repo.continuum.io/miniconda/Miniconda2-latest-Windows-x86_64.exe>`_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Mac <https://repo.continuum.io/miniconda/Miniconda2-latest-MacOSX-x86_64.sh>`_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Linux <https://repo.continuum.io/miniconda/Miniconda2-latest-Linux-x86_64.sh>`_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For more information, see: https://conda.io/miniconda.html |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. note:: |
|
|
|
|
|
|
|
|
|
|
|
**What is Miniconda?** |
|
|
|
**What is Miniconda?** |
|
|
|
|
|
|
|
|
|
|
|
If you have used the Anaconda distribution for Python before, then you will be |
|
|
|
If you have used the Anaconda distribution for Python before, then you will be |
|
|
@ -95,21 +112,6 @@ conda package manager. Since we are going to use the conda-forge channel to |
|
|
|
install our scientific packages, Miniconda avoids any complications between |
|
|
|
install our scientific packages, Miniconda avoids any complications between |
|
|
|
packages provided by Anaconda and conda-forge. |
|
|
|
packages provided by Anaconda and conda-forge. |
|
|
|
|
|
|
|
|
|
|
|
Please use the appropriate link below to download Miniconda for your operating |
|
|
|
|
|
|
|
system. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. note:: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
64-bit OS recommended |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Win64 <https://repo.continuum.io/miniconda/Miniconda2-latest-Windows-x86_64.exe>`_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Mac <https://repo.continuum.io/miniconda/Miniconda2-latest-MacOSX-x86_64.sh>`_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Linux <https://repo.continuum.io/miniconda/Miniconda2-latest-Linux-x86_64.sh>`_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For more information, see: https://conda.io/miniconda.html |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Step 3: Install Miniconda |
|
|
|
Step 3: Install Miniconda |
|
|
|
---------------------------- |
|
|
|
---------------------------- |
|
|
@ -197,12 +199,12 @@ Follow the instructions below to create the tutorial_2017 environment. |
|
|
|
|
|
|
|
|
|
|
|
Type or copy this command in to your command terminal:: |
|
|
|
Type or copy this command in to your command terminal:: |
|
|
|
|
|
|
|
|
|
|
|
conda create -n tutorial_2017 python=2.7 matplotlib=1.5.3 cartopy netcdf4 jupyter git wrf-python |
|
|
|
conda create -n tutorial_2017 python=2.7 matplotlib=1.5.3 cartopy netcdf4 jupyter git ffmpeg wrf-python |
|
|
|
|
|
|
|
|
|
|
|
Type "y" when prompted. It will take several minutes to install everything. |
|
|
|
Type "y" when prompted. It will take several minutes to install everything. |
|
|
|
|
|
|
|
|
|
|
|
This command creates an isolated Python environment named *tutorial_2017*, and installs |
|
|
|
This command creates an isolated Python environment named *tutorial_2017*, and installs |
|
|
|
the python interpreter, matplotlib, cartopy, netcdf4, jupyter, git, and wrf-python |
|
|
|
the python interpreter, matplotlib, cartopy, netcdf4, jupyter, git, ffmpeg, and wrf-python |
|
|
|
packages. |
|
|
|
packages. |
|
|
|
|
|
|
|
|
|
|
|
.. note:: |
|
|
|
.. note:: |
|
|
@ -214,17 +216,29 @@ Follow the instructions below to create the tutorial_2017 environment. |
|
|
|
5. Activate the conda environment. |
|
|
|
5. Activate the conda environment. |
|
|
|
|
|
|
|
|
|
|
|
To activate the tutorial_2017 Python environment, type the following |
|
|
|
To activate the tutorial_2017 Python environment, type the following |
|
|
|
in to the command terminal:: |
|
|
|
in to the command terminal: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For Linux and Mac (using bash):: |
|
|
|
|
|
|
|
|
|
|
|
source activate tutorial_2017. |
|
|
|
source activate tutorial_2017. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For Windows:: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
activate tutorial_2017 |
|
|
|
|
|
|
|
|
|
|
|
You should see (tutorial_2017) on your command prompt. |
|
|
|
You should see (tutorial_2017) on your command prompt. |
|
|
|
|
|
|
|
|
|
|
|
To deactivate your conda environment, type the following in to the |
|
|
|
To deactivate your conda environment, type the following in to the |
|
|
|
command terminal:: |
|
|
|
command terminal: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For Linux and Mac:: |
|
|
|
|
|
|
|
|
|
|
|
source deactivate |
|
|
|
source deactivate |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For Windows:: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
deactivate tutorial_2017 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Step 5: Download the Student Workbook |
|
|
|
Step 5: Download the Student Workbook |
|
|
|
--------------------------------------- |
|
|
|
--------------------------------------- |
|
|
@ -239,7 +253,8 @@ how to do this yourself. |
|
|
|
To download the student workbook, follow these instructions: |
|
|
|
To download the student workbook, follow these instructions: |
|
|
|
|
|
|
|
|
|
|
|
1. Activate the tutorial_2017 conda environment following the instructions |
|
|
|
1. Activate the tutorial_2017 conda environment following the instructions |
|
|
|
in the previous step (*source activate tutorial_2017*). |
|
|
|
in the previous step (*source activate tutorial_2017* or |
|
|
|
|
|
|
|
*activate tutorial_2017*). |
|
|
|
|
|
|
|
|
|
|
|
2. Change your working directory to the home directory by typing the |
|
|
|
2. Change your working directory to the home directory by typing the |
|
|
|
following command in to the command terminal: |
|
|
|
following command in to the command terminal: |
|
|
@ -255,7 +270,7 @@ To download the student workbook, follow these instructions: |
|
|
|
3. Download the git repository for the tutorial by typing the following |
|
|
|
3. Download the git repository for the tutorial by typing the following |
|
|
|
in to the command terminal:: |
|
|
|
in to the command terminal:: |
|
|
|
|
|
|
|
|
|
|
|
git checkout https://github.com/NCAR/wrf_python_tutorial |
|
|
|
git clone https://github.com/NCAR/wrf_python_tutorial.git |
|
|
|
|
|
|
|
|
|
|
|
4. There may be additional changes to the tutorial after you have downloaded |
|
|
|
4. There may be additional changes to the tutorial after you have downloaded |
|
|
|
it. To pull down the latest changes, type the following in to the |
|
|
|
it. To pull down the latest changes, type the following in to the |
|
|
@ -271,7 +286,7 @@ To download the student workbook, follow these instructions: |
|
|
|
|
|
|
|
|
|
|
|
For Windows:: |
|
|
|
For Windows:: |
|
|
|
|
|
|
|
|
|
|
|
source activate tutorial_2017 |
|
|
|
activate tutorial_2017 |
|
|
|
|
|
|
|
|
|
|
|
cd %HOMEPATH%\wrf_python_tutorial |
|
|
|
cd %HOMEPATH%\wrf_python_tutorial |
|
|
|
|
|
|
|
|
|
|
|