Skip to content

matteason/daily-cloud-maps

Repository files navigation

Warning

This project is being replaced by Live Cloud Maps and will stop being updated soon. Please update any image URLs you're using to point to the new project.

Daily cloud maps 🌍

This project creates and hosts daily cloud maps based on NASA data for use in 3D modelling software like Blender or Xplanet, or in 2D graphics.

TL;DR: If you need a high-res greyscale almost-live cloud map, use this URL:

https://matteason.github.io/daily-cloud-maps/8192x4096-clouds.jpg

If you have any feedback you can raise an issue, start a discussion or tweet me (@MattEason)

If you find this project useful and you're feeling spendy, you can support me on Ko-Fi:

Buy Me a Coffee at ko-fi.com

A realistic rendering of Earth, focussed on North America

A rendering of Earth using images generated by this project

Contents

Frequency & availability

Images are updated once a day. Each day's images are published to GitHub Pages, so if you configure your software to use https://matteason.github.io/daily-cloud-maps/[FILENAME] you'll always stay up-to-date.

You can download historic images from this project's Releases, or https://github.com/matteason/daily-cloud-maps/releases/download/[YYYY-MM-DD]/[FILENAME] - for example, https://github.com/matteason/daily-cloud-maps/releases/download/2022-07-27/8192x4096-clouds.jpg.

I can't guarantee the availability of any particular image; source data may not be available for a particular day if there's an issue with the satellites. I may also need to eventually delete historic images on a rolling basis if GitHub get cross with how much space they take up, so keep your own copy of anything important. If that might affect you, please watch this repo's Issues and I'll let you know if that happens.

GitHub allows CORS on Pages, so you can use the latest daily images directly in JavaScript - for example, in a three.js TextureLoader.

Unfortunately, because GitHub doesn't allow CORS on release assets you won't be able to use the historic images directly in JavaScript. You can either run a server-side process to download the image and serve it to your JavaScript, or find a CORS proxy that will do that and add the Access-Control-Allow-Origin: * header for you.

Available images

The following images are created daily. All images are available in four resolutions; replace [W]x[H] in the filenames below with one of 8192x4096, 4096x2048, 2048x1024 or 1024x512

The images shown are the latest images generated and refresh every day.

Cloud map: [W]x[H]-clouds.jpg

A greyscale cloud map

A greyscale cloud map. Layer this over an image of Earth (and set the blending mode to 'screen' if necessary).

Cloud map image URLs (all resolutions) These URLs are for the latest images:

You can download historic images from this project's Releases, or https://github.com/matteason/daily-cloud-maps/releases/download/[YYYY-MM-DD]/[FILENAME] - for example, https://github.com/matteason/daily-cloud-maps/releases/download/2022-07-27/8192x4096-clouds.jpg

Cloud map (alpha): [W]x[H]-clouds-alpha.png

A greyscale cloud map with transparency

The same as above, but as a PNG with alpha transparency (the preview above may not be visible if you use light mode)

Cloud map (alpha) image URLs (all resolutions) These URLs are for the latest images:

You can download historic images from this project's Releases, or https://github.com/matteason/daily-cloud-maps/releases/download/[YYYY-MM-DD]/[FILENAME] - for example, https://github.com/matteason/daily-cloud-maps/releases/download/2022-07-27/8192x4096-clouds-alpha.png

Earth with clouds (day): [W]x[H]-earth.jpg

A flat map of Earth with clouds

The cloud map overlaid on NASA's The Blue Marble: Land Surface, Ocean Color and Sea Ice image.

Earth with clouds (day) image URLs (all resolutions) These URLs are for the latest images:

You can download historic images from this project's Releases, or https://github.com/matteason/daily-cloud-maps/releases/download/[YYYY-MM-DD]/[FILENAME] - for example, https://github.com/matteason/daily-cloud-maps/releases/download/2022-07-27/8192x4096-earth.jpg

Earth with clouds (night): [W]x[H]-earth-night.jpg

A flat map of Earth at night with clouds obscuring the lights usually visible in populated areas

The cloud map overlaid on NASA's Earth at Night image. You can combine this with the day image using some fancy shader magic to create day/night transitions:

A rendering of the eastern hemisphere, half in daylight and half in darkness, with city lights showing

Earth with clouds (night) image URLs (all resolutions) These URLs are for the latest images:

You can download historic images from this project's Releases, or https://github.com/matteason/daily-cloud-maps/releases/download/[YYYY-MM-DD]/[FILENAME] - for example, https://github.com/matteason/daily-cloud-maps/releases/download/2022-07-27/8192x4096-earth-night.jpg

Specular map: [W]x[H]-specular.jpg

A flat map of Earth with clouds and the Earth's surface in black and the sea in white

You can use this specular map to make your model more realistic by only showing specular highlights on bodies of water:

A specular highlight on the sea off the west coast of Africa

Specular image URLs (all resolutions) These URLs are for the latest images:

You can download historic images from this project's Releases, or https://github.com/matteason/daily-cloud-maps/releases/download/[YYYY-MM-DD]/[FILENAME] - for example, https://github.com/matteason/daily-cloud-maps/releases/download/2022-07-27/8192x4096-specular.jpg

Limitations

The generated images have some limitations due to the source data.

Poles

The satellites tend not to capture the South Pole. To avoid harsh edges, a static image based on Blue Marble Clouds is overlaid on the bottom quarter of the live cloud map. This region isn't very visible on 3D images anyway, and most of the area is covered by the ice cap which makes the clouds even less visible.

Holes

Occasionally, the satellites capturing the source data will miss some regions. These areas will appear as square-ish holes without clouds.

Crop of a greyscale cloud map with large black squares in areas where cloud data is missing

Discontinuities

Because the satellites orbit the Earth, different regions are captured at different times. Sometimes when adjoining regions are captured at different times, an edge is visible due to the clouds moving between captures.

Licence & attribution

The source data used for these images is public domain, as works by US government agencies such as NASA aren't protected by copyright.

I've also released the code and images in this repository into the public domain using the CC0 1.0 Universal licence.

I'd appreciate an attribution if you use the code and images, but it's not necessary. Please also acknowledge NASA using the line below (which helpfully also serves as my acknowledgement to them):

I acknowledge the use of imagery provided by services from NASA's Global Imagery Browse Services (GIBS), part of NASA's Earth Observing System Data and Information System (EOSDIS).

Images are processed with the help of the excellent JIMP image manipulation library.

If you find this project useful, you can support me on Ko-Fi:

Buy Me a Coffee at ko-fi.com

Bonus info for nerds (how the maps are generated)

These cloud maps are generated using two NASA data sources, accessed via the GIBS API: 'Clear Sky Confidence' and 'Corrected Reflectance (True Color)', both captured by NOAA-20 / VIIRS. You can view these data layers on the NASA Worldview visualiser.

A map of where the earth is cloudy, ranging from dark red (no clouds) to cream (definitely clouds) A realistic map of the Earth with clouds over it

You may be wondering why you can't just use the true colour image directly - and you can, but because the satellites capture the earth in vertical strips, you end up with multiple specular reflections on the sea:

A 3D rendering of Earth. It appears to have highlights in multiple places, as if there are multiple suns

So we take the clear sky confidence and use it to mask the true colour image pixel-by-pixel by taking the confidence map pixel value, converting it to a confidence from 0.0 to 1.0 (how likely is it that the Earth is obscured by clouds?) and multiplying the pixel value of the true-colour image by that confidence. This means we retain the details from the true-colour image in the generated map. The result is then converted to greyscale to remove any residual colour from land or sea showing through the clouds.

Mosaic of four images showing the same area of the western United States: the original true-colour image, the dark red to cream cloud confidence layer, a composite image of a static image of Earth combined with our cloud map, and our greyscale cloud map

About

Creates daily cloud maps based on NASA data for 3D modelling

Resources

License

Stars

Watchers

Forks

Packages

No packages published