Iceberg-locations

Current Antarctic large iceberg positions derived from ASCAT and OSCAT-2

https://github.com/Joel-hanson/Iceberg-locations

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.3%) to scientific vocabulary

Keywords

beautifulsoup4 climate-change git-scraping iceberg python scraping
Last synced: 6 months ago · JSON representation

Repository

Current Antarctic large iceberg positions derived from ASCAT and OSCAT-2

Basic Info
Statistics
  • Stars: 6
  • Watchers: 1
  • Forks: 1
  • Open Issues: 0
  • Releases: 0
Topics
beautifulsoup4 climate-change git-scraping iceberg python scraping
Created about 5 years ago · Last pushed 6 months ago
Metadata Files
Readme License

README.md

Antarctic Iceberg Tracker

A Python tool for tracking large icebergs in Antarctic waters using satellite data from NASA's Scatterometer Climate Record Pathfinder (SCP).

Features

  • Real-time Data: Scrapes latest iceberg positions from NASA SCP website
  • Location Tracking: Precise latitude/longitude coordinates with DMS conversion
  • Interactive Map: Generate beautiful web-based visualizations with movement animations
  • GitHub Pages Deployment: Automatically deploy to a live website
  • Data Analysis: Summary statistics and iceberg movement tracking
  • JSON Export: Save data in structured format for further analysis
  • Simple CLI: Easy-to-use command-line interface

Live Demo

🌐 View the live Antarctic Iceberg Tracker: https://joel-hanson.github.io/Iceberg-locations/

The live site is automatically updated daily with the latest iceberg data and includes interactive features.

Quick Start

Installation

```bash

Clone the repository

git clone https://github.com/Joel-hanson/Iceberg-locations.git cd Iceberg-locations

Install dependencies

pip install -r requirement.txt ```

Usage

```bash

Collect latest iceberg data

python main.py scrape

Show data summary

python main.py info

Generate interactive map

python main.py map

View iceberg movement animations

python main.py animations ```

Commands

scrape - Collect Data

Fetches the latest iceberg position data from NASA SCP website and saves it to iceberg_location.json.

bash python main.py scrape

info - Data Summary

Displays statistics about the collected iceberg data including number of icebergs, observation dates, and data coverage.

bash python main.py info

Example output:

Antarctic Iceberg Data Summary: • 37 observation dates • 53 current icebergs • 97 unique icebergs tracked • 1,832 total records • Latest data: 11/11/21

map - Interactive Visualization

Generates an interactive HTML map showing iceberg positions with clickable markers.

bash python main.py map

Opens output/iceberg_map.html in your browser with:

  • Interactive Antarctica-focused map
  • Clickable iceberg markers with details
  • Movement animation links in each popup
  • Real-time statistics display

animations - Movement Animations

Shows URLs to animated GIF files demonstrating historical iceberg movement patterns.

bash python main.py animations

Example output:

``` Iceberg Movement Animations: Data from: 07/02/25 Note: Animations show historical movement patterns from NASA SCP

A23A | N/A, 39 7'W | https://ftp.scp.byu.edu/data/misc/iceberganimations/a23amovie.gif C18B | N/A, 78 17'E | https://ftp.scp.byu.edu/data/misc/iceberganimations/c18bmovie.gif ```

Copy the URLs to view GIF animations showing iceberg drift patterns over time.

Project Structure

Iceberg-locations/ ├── main.py # Main entry point ├── src/ # Source code │ ├── __init__.py # Package initialization │ ├── iceberg.py # Core scraper script │ ├── cli.py # Command-line interface │ ├── config.py # Configuration settings │ └── tests.py # Test suite ├── data/ # Data storage │ └── iceberg_location.json # Scraped data (generated) ├── output/ # Generated outputs │ └── iceberg_map.html # Interactive map (generated) ├── docs/ # Documentation ├── assets/ # Static assets ├── requirement.txt # Python dependencies ├── README.md # This file ├── LICENSE # MIT License ├── .github/workflows/ # GitHub Actions ├── Dockerfile # Docker container setup ├── Makefile # Build automation └── setup.py # Package installation

Data Source

Data is collected from the NASA Scatterometer Climate Record Pathfinder (SCP) database:

Current Data: https://www.scp.byu.edu/data/ice_tracking/antarctic.html Movement Animations: https://ftp.scp.byu.edu/data/misc/iceberg_animations/

The animation files show historical movement patterns of icebergs over time, providing valuable insights into iceberg drift patterns in Antarctic waters.

Data Format

json { "11/11/21": [ { "iceberg": "a23a", "latitude": -75.42, "longitude": -39.83, "dms_latitude": "75°25'S", "dms_longitude": "39°50'W", "recent_observation": "11/11/21" } ] }

Development

Local Development Server

```bash

Navigate to your project root

cd /path/to/Iceberg-locations

Generate the map first

python main.py map

Start a simple HTTP server

python -m http.server 8000

Visit: http://localhost:8000/output/iceberg_map.html

```

License

MIT License - see LICENSE file for details.

Owner

  • Name: Joel Hanson
  • Login: Joel-hanson
  • Kind: user
  • Company: @ibm

Software Engineer

GitHub Events

Total
  • Push event: 34
  • Pull request event: 3
  • Create event: 2
Last Year
  • Push event: 34
  • Pull request event: 3
  • Create event: 2

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 104
  • Total Committers: 2
  • Avg Commits per committer: 52.0
  • Development Distribution Score (DDS): 0.135
Past Year
  • Commits: 18
  • Committers: 2
  • Avg Commits per committer: 9.0
  • Development Distribution Score (DDS): 0.222
Top Committers
Name Email Commits
github-actions[bot] j****5@g****m 90
GitHub Action a****n@g****m 14
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • Joel-hanson (3)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

requirement.txt pypi
  • beautifulsoup4 ==4.9.3
  • lxml ==4.6.2
.github/workflows/deploy-pages.yml actions
  • actions/checkout v4 composite
  • actions/configure-pages v4 composite
  • actions/deploy-pages v4 composite
  • actions/setup-python v4 composite
  • actions/upload-pages-artifact v3 composite
.github/workflows/iceberg-tracker.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v4 composite
Dockerfile docker
  • python 3.12-slim build
setup.py pypi