ClimateSatellite.jl

Download satellite data for climate applications using Julia!

ClimateSatellite.jl aims to streamline the basic processing of satellite data for climate applications and research. This includes:

  • Downloading satellite datasets of interest (please see below for supported datasets)
  • Preliminary analysis of downloaded satellite data, including
    • Yearly and monthly mean, std, maximum and minimum of daily averages
    • Yearly and monthly mean, std, maximum and minimum of sub-daily raw data (where available)
    • All of the above in the 2D-spatial domain, as well as meridional-averaged and zonal-averaged domains.
  • Packing downloaded data into Int16 format to save disk-space
  • Extraction of data for specific geographic regions (GeoRegions)

Supported Datasets

The following datasets are currently supported by ClimateSatellite.jl:

IDMissionProductVersion
gpmimergPMMGlobal Precipitation Mission - IMERGv6 Researchpre-v1.0
gpmlatePMMGlobal Precipitation Mission - IMERGv6 NRT Late Runpre-v1.0
gpmearlyPMMGlobal Precipitation Mission - IMERGv6 NRT Early Runpre-v1.0
mtpw2mMIMICTotal Precipitable Water v2mpre-v1.0

I plan to release support for the following datasets:

IDMissionProductVersion
trmm3b42PMMTropical Rainfall Measuring Mission - 3B42v7 Researchv1.0
rsstmiRSSTRMM Microwave Imagerv1.1
rssgmiRSSGPM Microwave Imagerv1.1

Installation

ClimateSatellite.jl can be installed using Julia's built-in package manager as follows:

julia> ]
(@v1.4) pkg> add ClimateSatellite

You can update ClimateSatellite.jl to the latest version using

(@v1.4) pkg> update ClimateSatellite

And if you want to get the latest release without waiting for me to update the Julia Registry (although this generally isn't necessary since I make a point to release patch versions as soon as I find bugs or add new working features), you may fix the version to the master branch of the GitHub repository:

(@v1.4) pkg> add ClimateSatellite#master

Documentation

The documentation for ClimateSatellite.jl is divided into three components:

  1. Tutorials - meant as an introduction to the package
  2. How-to Examples - geared towards those looking for specific examples of what can be done
  3. API Reference - comprehensive summary of all exported functionalities
A Note on the Examples:

All the output for the coding examples were produced using my computer with key security information (such as login info) omitted. The examples cannot be run online because the file size requirements are too big. Copying and pasting the code examples (with relevant directory and login information changes) should produce the same results.

Getting help

If you are interested in using ClimateSatellite.jl or are trying to figure out how to use it, please feel free to ask me questions and get in touch! Please feel free to open an issue if you have any questions, comments, suggestions, etc!