An open API service indexing awesome lists of open source software.

https://github.com/thatsinewave/radiosonde-data-analyzer

A web-based tool for visualizing and analyzing radiosonde flight data from log files generated by the Radiosonde Decoder by 9A4AM
https://github.com/thatsinewave/radiosonde-data-analyzer

data-analysis data-analytics data-visualization good-first-contribution good-first-issue good-first-issues good-first-pr good-first-pr-first-contribution good-first-project good-first-prs good-practices html-css-javascript html-css-js radiosonde radiosonde-hunting radiosondes rtl-sdr sdr sdr-tool thatsinewave

Last synced: 8 months ago
JSON representation

A web-based tool for visualizing and analyzing radiosonde flight data from log files generated by the Radiosonde Decoder by 9A4AM

Awesome Lists containing this project

README

          

# Radiosonde Data Analyzer

A web-based tool for visualizing and analyzing radiosonde flight data from log files generated by the [Radiosonde decoder](https://github.com/9A4AM/Radiosonde-decoder-and-tracker-for-Windows) by 9A4AM.

![Radiosonde Data Analyzer](https://raw.githubusercontent.com/ThatSINEWAVE/Radiosonde-Data-Analyzer/refs/heads/main/.github/SCREENSHOTS/Radiosonde-Data-Analyzer.png)

## Features

- **Interactive Map Visualization**: View flight paths with multiple base map styles (Dark, Light, Terrain, Satellite)
- **Multi-Chart Analysis**:
- Altitude vs Time
- Horizontal Speed vs Time
- Vertical Velocity vs Time
- Direction Analysis
- **Statistics Dashboard**: Track total flights, max altitude, average duration, and max speed
- **Individual Sonde Control**: Toggle visibility of specific sondes for focused analysis
- **Responsive Design**: Works on desktop and mobile devices
- **File Directory Loading**: Load multiple log files at once from a folder

## ☕ [Support my work on Ko-Fi](https://ko-fi.com/thatsinewave)

## Live Demo

Access the web version hosted on GitHub Pages:
🌐 [thatsinewave.github.io/Radiosonde-Data-Analyzer](https://thatsinewave.github.io/Radiosonde-Data-Analyzer)

## Supported Log Format

This tool processes `.log` files generated by the 9A4AM Radiosonde decoder in the following format:
```
YYYY-MM-DD HH:MM:SS | Lat: XX.XXXXX, Lon: XX.XXXXX, Alt: XXXX.X m, vH: XX.X km/h, vV: X.X m/s, Dir: XXX.X
```

## Local Installation and Usage

### Option 1: Using GitHub Pages (Recommended)
Simply visit the live demo link above - no installation required!

### Option 2: Running Locally

1. **Clone or Download the Repository**
```bash
git clone https://github.com/ThatSINEWAVE/Radiosonde-Data-Analyzer.git
cd Radiosonde-Data-Analyzer
```

2. **Serve the Files with a Local Server**

Due to browser security restrictions, you need to serve the files through a local web server rather than opening the HTML file directly.

**Using Python:**
```bash
# Python 3
python -m http.server 8000

# Python 2
python -m SimpleHTTPServer 8000
```

**Using Node.js:**
```bash
npx http-server
```

**Using PHP:**
```bash
php -S localhost:8000
```

3. **Open Your Browser**
Navigate to `http://localhost:8000` (or the port you specified)

4. **Load Your Data**
- Click "Select Log Files Folder"
- Navigate to the folder containing your radiosonde `.log` files
- Select the folder (the app will load all `.log` files in that directory)

## How to Use

1. **Load Data**: Use the folder selection button to load your radiosonde log files
2. **Map Navigation**:
- Pan by dragging the map
- Zoom using mouse wheel or +/- buttons
- Switch between different map styles using the buttons in the sidebar
3. **Data Analysis**:
- Click on individual sondes in the sidebar to toggle their visibility
- Hover over points on the map to see detailed information
- Analyze trends across the four different charts
4. **Statistics**: View overall statistics in the sidebar panel

# [Join my discord server](https://thatsinewave.github.io/Discord-Redirect/)

## Generating Data

To create log files compatible with this analyzer:
1. Use the [Radiosonde decoder](https://github.com/9A4AM/Radiosonde-decoder-and-tracker-for-Windows)
2. Configure the software to output log files in the supported format (Should be by default)
3. The analyzer will automatically process the timestamp, coordinates, altitude, speeds, and direction data

## Browser Compatibility

- Chrome/Chromium (recommended)
- Firefox
- Safari
- Edge

Note: Some older browsers may not support all features.

## Technical Details

- Built with vanilla JavaScript (no frameworks)
- Uses Leaflet.js for map visualization
- Chart.js for data visualization
- Modern CSS with CSS Grid and Flexbox
- Responsive design that works on mobile and desktop

## Contributing

Contributions are welcome! Feel free to:
- Report bugs or issues
- Suggest new features
- Submit pull requests
- Improve documentation

## Acknowledgments

- [9A4AM](https://github.com/9A4AM) for the Radiosonde decoder and tracker software
- Leaflet.js for mapping functionality
- Chart.js for data visualization
- Font Awesome for icons

## License

This project is licensed under the GNU General Public License - see the [MIT License](LICENSE) file for details.