Classify climate regions with Python

The Winkler Index defines six climate regions, each suitable for growing different varieties and qualities of wines. In this tutorial, you'll use a provided notebook written in Python and run it in ArcGIS Pro to perform an analysis based on the Winkler Index. First, you’ll access multidimensional data. You'll then analyze the data to map Napa County, California, according to the Winkler Index. Finally, you'll create a chart to observe how the Winkler climate regions in Napa County have changed between 2000 and 2020.

The notebook provided for this tutorial can later be adapted to map other regions, time spans, and variables.

The multidimensional data used in this tutorial is from Daymet. Daymet is a weather dataset published by the National Aeronautics and Space Administration (NASA). It maps weather and climate estimates for all of North America, including daily minimum and maximum temperature, precipitation, vapor pressure, day length, and other variables. Daymet data is multidimensional, with a 1 km resolution, and is available for all dates since 1980. You can learn more about this dataset at the Daymet Description web page.

This tutorial was last tested on January 31, 2025, using ArcGIS Pro 3.4. If you're using a different version of ArcGIS Pro, you may encounter different functionality and results.

Requirements

• ArcGIS Pro (see options for software access)
• ArcGIS Image Analyst extension

Classify climate regions with Python

Register an Earthdata account

Before running the Python notebook, you first must perform a few preliminary tasks.

The Daymet data is available for anyone to use; however, you must create an Earthdata account to access it. Earthdata accounts are free and give you access to all of the data in NASA's Earth Observing System Data and Information System (EOSDIS).

Note:

If you already have an Earthdata account, skip to the next section.

1. Open the Register for an Earthdata Login Profile web page.
2. Complete the form on this page. In the Affiliations section, the following answers are suggested:
   • For Affiliation, choose Education.
   • For User Type, choose Public User.
   • For Study Area, choose Land Processes.
3. Check the I'm not a robot check box.
4. Click Register for Earthdata Login.
5. Close the Earthdata web page.

Build a Python environment

You'll make a clone of the default arcgispro-py3 environment and add the Pydap package to the cloned environment. Pydap is a Python library that implements the OPeNDAP protocol. OPeNDAP provides access to hundreds of scientific datasets, including Daymet.

You'll use the ArcGIS Pro Package Manager to create the new environment and add the new package.

1. Open ArcGIS Pro and on the start page, click Settings.

   

   You'll clone the default arcgispro-py3 environment and name the new environment arcpydap.

2. On the Settings pane, click Package Manager.

   

3. On the Package Manager pane, for Active Environment, click the settings button.

   

4. On the Environment Manager window, in the arcgispro-py3 (Default) row, click Clone environment.

   

   The Clone Environment window opens.

   

5. On the Clone Environment window, in the Destination box, edit the final part of the environment path to change the cloned environment name from arcgispro-py3-clone to arcpydap.

   

6. Click OK.

   On the Environment Manager, an indicator will appear beside the arcgispro-py3 (Default) row to show that the environment is being cloned.

   

   The cloning process will take about 2 minutes to run.

   When the process is complete, a new row will be added to the Environment Manager for the arcpydap environment.

   

7. On the Environment Manager, in the arcpydap row, point to the end of the row and click the More options button, then click Activate.

   

   The new environment will be activated. This process will take several seconds.

8. On the Environment Manager, click OK.
9. Close ArcGIS Pro, then restart ArcGIS Pro.

   This ensures that the new environment will be active for the new ArcGIS Pro session.

10. On the start page, click Settings, and on the Settings pane, click Package Manager.

    On the Package Manager pane, the Active Environment should be arcpydap.

    

11. On the Package Manager pane, click Add Packages.

    

12. In the Search box, type pydap.

    

13. In the results, for Pydap, click Install.

    

14. Check the box to agree to the terms of use and click Install.

    

    The installation process will take a minute. When it is complete, a green check will appear beside it in the Tasks section.

    

15. Close ArcGIS Pro.

Work in ArcGIS Pro

Next, you'll open the provided ArcGIS Pro project. You'll continue the tutorial with the notebook provided in the project.

1. Download the Napa_Daymet.zip file.
2. Locate the downloaded file and unzip it to drive C, so the folder path is C:\Napa_Daymet.

   Caution:

   Some data connections will be broken if you unzip the file to a location other than drive C.

   

3. Open the unzipped Napa_Daymet folder and double-click Napa_Daymet.aprx (or Napa_Daymet) to open it in ArcGIS Pro.

   

4. If prompted, sign in with your ArcGIS account.

   If you don't have access to ArcGIS Pro or an ArcGIS organizational account, see options for software access.

   ArcGIS Pro appears, showing a small map with the outline of Napa County, California, and a notebook. This notebook is the Daymet.ipynb file found in the Napa_Daymet folder.

5. Click the Daymet Notebook tab.

   The notebook includes all of the necessary instructions.

6. Read and run each cell in the notebook.

   

Note:

You can learn more about running notebooks in ArcGIS Pro in the tutorial Get started with notebooks in ArcGIS Pro.

Acknowledgements

• Daymet data: Thornton, M.M., R. Shrestha, Y. Wei, P.E. Thornton, S-C. Kao, and B.E. Wilson. 2022. Daymet: Daily Surface Weather Data on a 1-km Grid for North America, Version 4 R1. ORNL DAAC, Oak Ridge, Tennessee, USA. https://doi.org/10.3334/ORNLDAAC/2129
• Napa_County: derived from USA Census Counties, U.S. Census Bureau, Esri.
• Dark Gray Canvas map sources: Esri, TomTom, Garmin, FAO, NOAA, USGS, OpenStreetMap contributors, and the GIS User Community
• Boone, Virginie, "Climate Change Forces California Winemakers to Reconsider What Grapes Grow Where," Beverage Industry Enthusiast, August 4, 2021. Accessed February 2023.
• Amerine M., A. Winkler. "Composition and Quality of Musts and Wines of California Grapes," 15(6):493-675, February 1944. DOI:10.3733/hilg.v15n06p493. Accessed February 2023.