Skip to main content
Ctrl+K

Geodata 0.1.0 documentation

Quickstart

  • Installation
  • Supported Input/Output Formats

Dataset Specific Tutorials

  • ERA5 Related Tutorials
    • ERA5 Analysis Process
    • Download ERA5 Dataset and Create ERA5 Cutouts
    • Generating Outputs with ERA5 Data
  • MERRA2 Related Tutorials
    • MERRA2 Analysis Process
    • Download MERRA2 Data and Create MERRA2 Cutouts
    • MERRA2 Ouputs
  • Advanced: Structure of Weather Data Configuration

Mask

  • Tutorial: Typical Mask Workflow
  • Tutorial: Incorporating Mask into Cutout Workflow
  • Mask Troubleshooting

Visualization

  • Visualization Examples

Modeling

  • Wind Modeling
    • Tutorial: Estimate Wind Speed with Interpolation
    • Tutorial: Estimate Wind Speed with Extrapolation

API Reference

  • API Reference
    • geodata
      • geodata.datasets
        • geodata.datasets.era5
        • geodata.datasets.merra2
      • geodata.model
        • geodata.model.wind
      • geodata.pv
        • geodata.pv.irradiation
        • geodata.pv.orientation
        • geodata.pv.solar_panel_model
        • geodata.pv.solar_position
      • geodata.config
      • geodata.convert
        • geodata.convert.convert_cutout
        • geodata.convert.convert_temperature
        • geodata.convert.temperature
        • geodata.convert.convert_soil_temperature
        • geodata.convert.soil_temperature
        • geodata.convert.convert_heat_demand
        • geodata.convert.heat_demand
        • geodata.convert.convert_solar_thermal
        • geodata.convert.convert_pv
        • geodata.convert.convert_wind
        • geodata.convert.convert_windspd
        • geodata.convert.convert_windwpd
        • geodata.convert.convert_pm25
        • geodata.convert.get_var
        • geodata.convert.compute_var
      • geodata.cutout
        • geodata.cutout.Cutout
        • geodata.cutout.ds_reformat_index
        • geodata.cutout.coarsen
        • geodata.cutout.calc_grid_area
        • geodata.cutout.calc_shp_area
      • geodata.dataset
        • geodata.dataset.Dataset
      • geodata.logging
        • geodata.logging.CustomFormatter
        • geodata.logging.colorize
      • geodata.mask
        • geodata.mask.Mask
        • geodata.mask.open_tif
        • geodata.mask.ras_to_xarr
        • geodata.mask.create_temp_tif
        • geodata.mask.save_opened_raster
        • geodata.mask.save_raster
        • geodata.mask.crop_raster
        • geodata.mask.reproject_raster
        • geodata.mask.apply_fn_to_raster
        • geodata.mask.filter_raster
        • geodata.mask.trim_raster
        • geodata.mask.filter_area
        • geodata.mask.convert_shape_crs
        • geodata.mask.show
        • geodata.mask.show_all
      • geodata.plot
        • geodata.plot.ds_ts_aggregate
        • geodata.plot.time_series
        • geodata.plot.heatmap
        • geodata.plot.heatmap_animation
        • geodata.plot.save_animation
      • geodata.preparation
        • geodata.preparation.cutout_do_task
        • geodata.preparation.cutout_prepare
        • geodata.preparation.cutout_produce_specific_dataseries
        • geodata.preparation.cutout_get_meta
        • geodata.preparation.cutout_get_meta_view
      • geodata.resource
        • geodata.resource.get_windturbineconfig
        • geodata.resource.get_solarpanelconfig
        • geodata.resource.solarpanel_rated_capacity_per_unit
        • geodata.resource.windturbine_rated_capacity_per_unit
        • geodata.resource.windturbine_smooth
      • geodata.utils
        • geodata.utils.NpEncoder
        • geodata.utils.make_optional_progressbar
        • geodata.utils.dummy_njit
        • geodata.utils.get_daterange
      • geodata.wind
        • geodata.wind.log_ratio
        • geodata.wind.log_law
        • geodata.wind.psi_linear
        • geodata.wind.psi_linearexp
        • geodata.wind.psi_linearexpconst
        • geodata.wind.L_vph
        • geodata.wind.winddir
        • geodata.wind.log_law_flux_linear
        • geodata.wind.log_law_flux_linearexp
        • geodata.wind.log_law_flux_linearexpconst
        • geodata.wind.extrapolate_wind_speed
      • geodata.Cutout
        • geodata.Cutout.datasetfn
        • geodata.Cutout.grid_coordinates
        • geodata.Cutout.grid_cells
        • geodata.Cutout.add_mask
        • geodata.Cutout.add_grid_area
        • geodata.Cutout.mask
        • geodata.Cutout.heat_demand
        • geodata.Cutout.temperature
        • geodata.Cutout.soil_temperature
        • geodata.Cutout.solar_thermal
        • geodata.Cutout.wind
        • geodata.Cutout.windspd
        • geodata.Cutout.windwpd
        • geodata.Cutout.pv
        • geodata.Cutout.pm25
      • geodata.Dataset
        • geodata.Dataset.datasetfn
        • geodata.Dataset.datasetfn_opendap
        • geodata.Dataset.get_data
        • geodata.Dataset.trim_variables
        • geodata.Dataset.grid_coordinates
        • geodata.Dataset.grid_cells
      • geodata.Mask
        • geodata.Mask.add_layer
        • geodata.Mask.remove_layer
        • geodata.Mask.rename_layer
        • geodata.Mask.get_res
        • geodata.Mask.get_bounds
        • geodata.Mask.find_inner_bound
        • geodata.Mask.crop_layer
        • geodata.Mask.trim_layer
        • geodata.Mask.filter_layer
        • geodata.Mask.merge_layer
        • geodata.Mask.remove_merge_layer
        • geodata.Mask.add_shape_layer
        • geodata.Mask.extract_shapes
        • geodata.Mask.remove_shapes
        • geodata.Mask.load_merged_xr
        • geodata.Mask.load_shape_xr
        • geodata.Mask.close_files
        • geodata.Mask.save_mask
        • geodata.Mask.from_name
  • .md

MERRA2 Related Tutorials

Contents

  • Creating an Earthdata Login Profile and Approving the GES DISC App
  • Configure API Crendentials
    • macOS/Linux
    • Windows
  • What’ next?

MERRA2 Related Tutorials#

This page explains how you can setup access MERRA2 data from NASA’s GES DISC.

Creating an Earthdata Login Profile and Approving the GES DISC App#

To download MERRA2 data, you’ll need to create an Earthdata Login.

After creating an account, you’ll need to connect your account to GES DISC to access data.

The following procedure is sourced from GES DISC’s documentation:

  1. Login to https://urs.earthdata.nasa.gov/.

  2. Click on the ‘Applications’ tab in the top menu bar, and in the pop up menu, select the ‘Authorized Apps’ tab.

  3. Scroll to bottom of page to find the “Approve More Applications” button. Click it to open the search bar.

  4. Search for and select the NASA GESDISC DATA ARCHIVE. Once you’ve clicked approve, agree to the EULA.

  5. The data source has now been connected to your account.

Configure API Crendentials#

To download MERRA2 data via geodata you’ll need to install the API credentials locally.

macOS/Linux#

For MacOS, create a file in your root directory (cd ~) called .netrc by opening a terminal window and running touch ~/.netrc to create the file and then execute the following command:

echo "machine urs.earthdata.nasa.gov login [login] password [password] " >> .netrc

where [login] is your Earthdata user name and [password] is your Earthdata Login password.

Windows#

For Windows, open Notepad and enter the following line in a new document, making sure to substitute <uid> and <password>for your Earthdata login credentials:

machine urs.earthdata.nasa.gov login <uid> password <password>

Save the file to C:\Users\<username>\.netrc

What’ next?#

We provide a few more tutorials on how to download and utilize the MERRA2 dataset with Geodata. You can find them below.

  • MERRA2 Analysis Process
    • Step 1 - Setup
    • Step 2 - Download
    • Step 3 - Create Cutout
    • Step 4 - Generate Outputs
  • Download MERRA2 Data and Create MERRA2 Cutouts
    • Download Dataset
    • Preparing the cutout
    • Cutout Metadata
  • MERRA2 Ouputs
    • MERRA2 Configs and Outputs
    • Generating Wind Outputs with MERRA2 Data
    • Wind Generation Time-series
    • Wind Power Density Time-series
    • Generating Solar Outputs with MERRA2 Data
    • Generating Aerosol Outputs with MERRA2 Data

previous

Generating Outputs with ERA5 Data

next

MERRA2 Analysis Process

Contents
  • Creating an Earthdata Login Profile and Approving the GES DISC App
  • Configure API Crendentials
    • macOS/Linux
    • Windows
  • What’ next?

By Geodata Contributors

© Copyright 2023, Geodata Contributors.