This tutorial will show you how to download ECOSTRESS data from Earthdata Search on Windows.
Requesting files from Earthdata Search
Downloading the files to your Computer
Earthdata Search is a customized search experience that allows users to filter and discover data. It allows for easy access and use of NASA’s Earth Observing System Data and Information System (EOSDIS). There is a variety of data available, including ECOSTRESS data.
- Start by going to https://search.earthdata.nasa.gov/search or by searching for Earthdata Search on the Web. In the top right, select Earthdata Login. This will take you to the Earthdata Login page.
- Type in your username and password and select Login. This will redirect you back to the Earthdata Search page.
- The left most panel of the Earthdata Search window is where you can search for data. The preferences that you set in the left panel will change what results are shown in the middle panel. Let’s look at some of the ways we can do this. First, at the very top there is a search bar that says Search for collections or topics. This allows you to search for different products or key words if you know exactly what you are looking for. Select the eraser icon to clear your search.
- Below that we have three filtering options available. The first Calendar icon allows you to set start and end dates to filter your search. This is called a Temporal filter. To confirm, click Apply.
- Next, the icon that looks like a crop symbol allows you to set a Spatial filter around your area of interest. If you click on it, a dropdown will appear with different options.
-
You can select polygon to draw a shape with points on the map. To finish the polygon, either double click or click on the first point.
-
You can select a predefined shape (Rectangle or Circle) or Point and place it on the map.
-
Or, you can upload a shapefile by selecting File. This will open a pop-up that will allow you to Browse Files on your computer. Make sure the file is in one of the valid formats listed. Alternatively, you can drag and drop shapefiles directly onto the map.
- The last icon is the advanced search icon this allows you to search for Hydrological Units (HUC ID), if that is something you are interested in.
- To practice searching for ECOSTRESS data, let’s do a practice example. For this example, leave the temporal filter and advanced search blank. For the Spatial filter, zoom into southern California and find the Salton Sea. Use the Rectangle option under the Spatial filter to draw a box around the Salton Sea.
- Now let’s look at the Filter Collections box. This box allows you to select preferences for your search based of criteria in different categories including Keywords, Projects, Data Format, and so much more. If you are interested in using a variety of NASA’s Earthdata, I encourage you to explore and see your different options!
- To find ECOSTRESS data, click the dropdown next to the Projects category in the Filter Collections box. In the list of options, scroll down to ECOSTRESS and click the box next to it to make a checkmark appear. You will now see that next to Projects it says 1 Selected and the middle panel now shows ECOSTRESS products.
- You can also filter the ECOSTRESS products by data type. To do this, click the dropdown next to Data Format and select the box next to the data type you prefer. In this case, let’s select Cloud Optimized GeoTIFF (COG).
- Now in the center panel, you will see a list of all ECOSTRESS collections with a GeoTIFF data type. You can scroll through the options to see what is available in the area you selected. If you hover your mouse over the collection, more options will appear. Select the i information icon to learn more about the collection. You can also select the green plus to add the entire collection to your project to later download.
- For now, let’s just click on the name of the first collection listed. It should be ECOSTRESS Tiled Land Surface Temperature and Emissivity Instantaneous L2 Global 70 m V002.
- Once you click on the collection, the middle panel will now display the granules available in that collection that align with your search parameters. You will also see a timeline at the bottom of the screen. The green bars on the timeline represent the dates when ECOSTRESS data with the specifications you provided is available. This timeline is interactive and can be used instead of setting a temporal resolution with the calendar icon I showed before.
- To set a temporal filter using the timeline, start by adjusting the units. Click the up or down arrows to change the units from Day, to Month, to Year. For now, I will set mine to Year.
- Next, hold your mouse in the dark gray section above the timeline and drag across the times you want to filter. Once you let go, a red filter will be placed over the times you selected. If you want to adjust the filter, click and drag the end lines of the filter to a new position. For now, I want to filter for data from the year 2023.
- Now let’s investigate the granules available. If it is helpful to you, you can sort them based on start date or end date being the oldest or newest by selecting an option under the Sort dropdown.
- Also, if you hover over the View icon that looks like bullet points, you can choose to view the granules as a list or a table.
- Next, hover your mouse over one of the granules listed. Notice that a green box appears around the granule’s description. Also, the location of the granule is highlighted on the map.
- In the box with the granule description, there are a few more ways you can interact with it. You can select the green plus sign to add it to a project to be downloaded later.
- You can also select the download button to instantly download just that granule. This is especially helpful if you just want one file to run tests with.
- Also, if you click the three dots menu, you can either select View details which will give you more information and metadata on the granule, or you can select Filter granule to hide that specific file from your search.
- For the sake of our practice example, let’s download a few granules. I am going to select the green plus sign next to the seven granules I found for my area taken on December 14th, 2023 (2023-12-14). You will notice a few things on your screen change. First, the green plus signs become red minus signs which you can click if you want to remove them from the selection. Also, the green Download button now displays the number of granules selected (7). Finally, at the top right of the screen you should see a new tab titled My Project. To continue, click on either the green Download button or the My Project tab. Both of these options will take you to the download window.
- In the download window you will have the option to name your project by clicking the pen and paper icon next to Untitled Project. This is helpful if you ever want to revisit this download or share it with others. I am going to call this search Salton_Sea_ECOSTRESS.
- Now when you select your profile in the top right and go to Saved Projects you will see the Salton_Sea_ECOSTRESS project.
- The center pane of the download window is where you set Edit Options. Depending on the product you are downloading, there may be more options available. For this example, we will just keep the default options. Now press Download Data to start downloading.
- Finally, this will take you to a Download Status page where you can track your orders being processed.
- There are a few ways to actually download the files to your computer. If you have a preferred way to do this, you can go ahead with that method. However, this tutorial will show you how to install Earthdata Download in order to download the files. To start, scroll down and click the Download Files button.
- In the pop up, look for the link under Don’t have Earthdata Download Installed? and click on where it says Downloads Page.
- On the new website, click the Download for Windows button.
- Go to your downloads folder and double click on the installer to launch it.
- You might get a pop-up saying Windows protected your PC. If this happens, press More info.
- Then select Run Anyway.
- In the new set-up window, press Next.
- Then, press Install.
- Once it has finished installing, press Finish to close the installer.
- Now that we have Earthdata Download installed, lets open it. To do this, search for Earthdata Download in the Windows search bar and press Enter to open it.
- Once you have the Earthdata Download application open, go back to your Earthdata request Download Status page and select the Download Files button.
- A pop-up may appear asking you if you would like to open Earthdata Download. Click Open Earthdata Download.
- A new pop-up will appear in the Earthdata Download application. It will ask you to set a location on your computer for the downloaded files to go. By default, this is listed as your downloads folder, however if you would like to change it, you can do so now. Also, there is a check box allowing you to decide if you want to be asked this question again. Once you have made your decisions, press the Begin download button.
- Next, a window will pop-up asking you to login to Earthdata Search. Enter your credentials and press Log In.
- You may get another pop-up asking to again open Earthdata Download. Click Open.
- Go back to the Earthdata Download application. You should see a progress bar showing how much of the data has been downloaded. Let it finish downloading.
Tip: If your download time keeps passing, but there is no progress in the number of files being downloaded, there are a few things you can do to fix this. First, try pausing and resuming the download.
If there is still no progress being made, click on the download.
In the new screen, all the files will be listed with their status. Click the checkbox to Hide Complete files.
Then, find the file or files that are stuck and not downloading. They should say Not yet started. Hover over the file name, click on the three dots, and select Restart File. This should cause it to start downloading.
Furthermore, if you get a warning that looks like this, just press Retry and it should resolve.
- You will know it is done downloading the files when it says complete.
You now have ECOSTRESS files downloaded to your computer!
Tip: You can look at the ECOSTRESS Naming Conventions to help make sense of the files you downloaded!