https://github.com/serialphotog/noaa-animator
A simple utility to generate animated GIFs from NOAA weather maps.
https://github.com/serialphotog/noaa-animator
animated-gif gif noaa php weather
Last synced: 8 months ago
JSON representation
A simple utility to generate animated GIFs from NOAA weather maps.
- Host: GitHub
- URL: https://github.com/serialphotog/noaa-animator
- Owner: serialphotog
- License: mit
- Created: 2018-08-16T17:44:26.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-16T17:45:56.000Z (about 7 years ago)
- Last Synced: 2024-01-29T03:18:50.317Z (over 1 year ago)
- Topics: animated-gif, gif, noaa, php, weather
- Language: PHP
- Size: 8.79 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# NOAA Weather Map Animator
The National Oceanic and Atmospheric Administration (NOAA) publishes various graphical weather maps online. These maps can be found [here](https://graphical.weather.gov/images/). Each forecast has a number of individual frames representing a forecast for a different moment in time. By using these as frames in an animated GIF, we can create a simple, animated weather forecast image. This project allows for the automatic creation of said GIFs.
# Configuration
All of the configuration options are located in the **noaa_animator.conf.php** file. This file contains a number of defines that affect how the maps are generated. Here are the configuration options:
## NOAA_ANIMATE_STATE
This configures the state to generate maps for. Each state should be spelled out in lowercase. For example, to get the maps for Kentucky, I'd set this value to *kentucky*.
## NOAA_ANIMATE_OUTPUT_PATH
This is the output path for all of the rendered gifs.
**NOTE:** Each rendered gif will be placed within its own subdirectory within this path. The name of this subdirectory is the same as the code-name used by NOAA. A list of these codes can be found below.
## NOAA_ANIMATE_FRAME_DELAY
The delay between each frame in the resulting GIF animation. This is measured in ticks. A GIF has 100 ticks/second, so a value of 100 is 1 second and 50 is 1/2 of a second.
## The Various Map Types
Each map type has two configuration options associated with it.
The first is a true/false boolean value that determines rather or not we want to generate that type of map. Setting this value to *true* will cause the application to generate an animated gif for that map, *false* means it will not be generated.
The second configuration option contains the total number of frames for the complete animation. This is determined by how many frames are available on the NOAA server. You can likely just leave these as default.
## Map Type Codes
At the very bottom of the configuration file are a series of defines for the various map types. These should likely be left as default. **You should only edit these values if you know what you're doing**.
# Map Codes
As mentioned above, each rendered map is stored in a subdirectory with the same name as the NOAA map code. Here is a list of the codes:
* **ConvOutlook:** Convective outlook forecast
* **HailProb:** Hail probability forecast
* **IceAccum:** Ice accumulation forecast
* **RH:** The relative humidity forecast
* **MaxT:** The max temperature forecast
* **MinT:** The min temperature forecast
* **PoP12:** The 12-hour precipitation probability forecast
* **ProbDryLightning24:** Forecasts the probability of dry lightning over the next 24-hours.
* **ProbFireWx24:** 24-hour fire probability outlook.
* **QPF:** The 6-hour precipitation forecast
* **Sky:** The total sky cover forecast
* **SnowAmt:** Snow accumulation forecast
* **T:** Temperature forecase
* **Td:** Dewpoint temperature forecast
* **TornadoProb:** The forecase for the probability of a tornado
* **WindGust:** The windgust forecast
* **WindSpd:** The windspeed forecast