{"id":13585715,"url":"https://github.com/a3r0id/nesdis-goes","last_synced_at":"2025-04-07T10:31:32.049Z","repository":{"id":151369743,"uuid":"291252077","full_name":"a3r0id/nesdis-goes","owner":"a3r0id","description":"Downloads satellite imagery directly from star.nesdis.noaa.gov. Also compiles gifs and a few other utilities.","archived":true,"fork":false,"pushed_at":"2022-11-05T01:17:18.000Z","size":17103,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-02-14T21:14:52.987Z","etag":null,"topics":["compiles-gifs","geospatial","geospatial-analysis","imagery","imagery-analysis","nesdis","osint","reconnaissance","sattelite","scraper","weather"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a3r0id.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-08-29T10:47:03.000Z","updated_at":"2023-10-05T04:25:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"fd1490a1-b4e6-454e-8613-73137ec7360a","html_url":"https://github.com/a3r0id/nesdis-goes","commit_stats":{"total_commits":40,"total_committers":2,"mean_commits":20.0,"dds":0.25,"last_synced_commit":"071327bb2599cd120c5feb3a8beb337fd28a3619"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3r0id%2Fnesdis-goes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3r0id%2Fnesdis-goes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3r0id%2Fnesdis-goes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3r0id%2Fnesdis-goes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a3r0id","download_url":"https://codeload.github.com/a3r0id/nesdis-goes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247636418,"owners_count":20970927,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["compiles-gifs","geospatial","geospatial-analysis","imagery","imagery-analysis","nesdis","osint","reconnaissance","sattelite","scraper","weather"],"created_at":"2024-08-01T15:05:06.182Z","updated_at":"2025-04-07T10:31:31.692Z","avatar_url":"https://github.com/a3r0id.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# nesdis-goes (Unofficial)\nThis API downloads and manipulates GOES-16/17 satellite imagery directly from star.nesdis.noaa.gov based on various searchable data-points. \n\n## Setup:\n\u003e Simply move the contents of `/src` to your project folder.\n\n*Sped up to 8x for first half of gif.*\n\u003cbr/\u003e\n![](https://raw.githubusercontent.com/hostinfodev/nesdis-goes/master/ezgif-1-41d268808025.gif)\n\n\n## Basic Usage:\nThis API accepts a mixed query (dictionary):\n\n(sector: `string`)\n\u003e The group of imagery's region (string of keywords).\n``Example: \"north pacific ocean\"``\n\n(band: `string`)\n\u003e The group of imagery's type or band(string of keywords).\n``Example: \"cloud weather\"``\n\n(dimensions: `list`)\n\u003e The desired dimensions of each image in the group of images's.\n``Dimensions are limited to [250,250] or [500, 500] or [1000, 1000] or [2000, 2000].``\n\nFor all options visit:\n[Here for all sectors](https://www.star.nesdis.noaa.gov/goes/index.php)\n[Here for all bands](https://www.star.nesdis.noaa.gov/goes/conus.php?sat=G17)\n\n### API Methods:\n`API.showimages()`\n\u003cbr/\u003e\n\u003e Opens each image received, will cause issues if many results (buggy).\n\n`API.makeGif(GIFname: string)`\n\u003cbr/\u003e\n\u003e Creates a GIF from each image received.\n\n`API.cleanUp()`\n\u003cbr/\u003e\n\u003e Deletes all downloaded images.\n\n`API.payload`\n\u003cbr/\u003e\n\u003e The final query result object, holds all results from query.\n\n\n```python\n\n# Import the API\nfrom NesdisAPI import nesdis\n\n# BASIC USAGE\nAPI = nesdis(\n    {\n        \"sector\": \"virginia state\",\n        \"band\": \"physics micro\",\n        \"dimensions\": [250,250]\n    }\n)\n\nmyGif = \"test1.gif\"\n\nAPI.makeGif(myGif)\n\nAPI.cleanUp()\n```\n\n\n## Advanced Usage:\n\nAccepts same query as *Basic Options* plus:\n\n(time: `dict`)\n\u003e Sets either a timeframe from now and minus `x` amount of either hours(`int`) or days(`int`) \n\n\u003e Example: `\"time\": {\"days\": 2}`\n\n**or**\n\n\u003e sets a split time from, essentially a time between **x**(`datetime string`) and **y**(`datetime string`),\nwe'll use \"oldest\" and \"newest\" instead of x/y.\n\n\u003e Example: `\"time\": {timeframe: {\"oldest\": \"2020-08-01 12:30\", \"newest\": \"2020-08-1 13:30\"}}`\n\n(type: `string`) \n**Do Not Change** - *for further implementations only*\n\nSets the type of images to select.\nTypes are: `default`(defaults to this and really shouldn't be changed), `thumbnail`, `unknown`, `banner`\nNote: Not really useful at this point in time, I will use this later to call specific images that are not the default slid images like thumbnails etc.\n\n```python\n\n# Import the API\nfrom NesdisAPI import nesdis\n\n# ADVANCED USAGE\nAPI = nesdis(\n    {\n        \"sector\": \"virginia state\",\n        \"band\": \"physics micro\",\n        \"time\": {timeframe: {\"oldest\": \"2020-08-01 12:30\", \"newest\": \"2020-08-30 23:30\"}},\n        \"dimensions\": [250,250]\n    }\n)\n\nprint(API.payload)\n\nmyGif = \"test1.gif\"\n\nAPI.makeGif(myGif)\n\nAPI.cleanUp()\n```\n\nNote: I'll eventually move this to a module that way it can be installed easier via PIP and properly imported.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa3r0id%2Fnesdis-goes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa3r0id%2Fnesdis-goes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa3r0id%2Fnesdis-goes/lists"}