Documentation

The AeroViz atmospheric monitoring system is a comprehensive platform designed for real-time air quality monitoring, data analysis, and environmental research. Our system integrates multiple data sources including ground-based sensors, satellite imagery, and meteorological data to provide accurate and timely air quality information.

Key Features

• Real-time Monitoring: Continuous air quality data collection and visualization
• Multi-sensor Integration: Support for various sensor types and data formats
• Advanced Analytics: Machine learning algorithms for data analysis and prediction
• Alert System: Automated notifications for air quality events
• API Access: RESTful API for third-party integrations

Prerequisites

Before installing AeroViz, ensure you have the following prerequisites:

• Python 3.8 or higher
• PostgreSQL 12 or higher
• Node.js 16 or higher (for frontend development)
• Git for version control

Installation Steps

# Clone the repository
git clone https://github.com/aeroviz/aero-web-server.git
cd aero-web-server

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your configuration

# Initialize database
python script/init_database.py

# Start the application
python aero_web_app/run.py

Get started with AeroViz in just a few steps:

1. Access the Dashboard

After installation, navigate to http://localhost:5000 to access the main dashboard.

2. Configure Sensors

Add your air quality sensors through the management interface:

1. Go to Admin → Sensor Management
2. Click Add New Sensor
3. Enter sensor details and connection parameters
4. Test the connection and save

3. Set Up Alerts

Configure alert thresholds for different air quality parameters:

1. Navigate to Settings → Alert Configuration
2. Set threshold values for PM2.5, PM10, O₃, etc.
3. Configure notification methods (email, SMS, webhook)
4. Test alert functionality

The AeroViz API provides programmatic access to air quality data and system functionality. All API endpoints are RESTful and return JSON responses.

Base URL

https://api.aeroviz.com/api/v1/

Authentication

Most API endpoints require authentication. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Common Endpoints

Our integrated instrument setup enables comprehensive characterization of atmospheric aerosols, measuring various properties including size distribution, chemical composition, optical properties, and mass concentration.

Available Instruments

Detailed technical specifications for our atmospheric monitoring instruments:

Data Collection & Integration

All instruments are integrated into our centralized data collection system, which:

• Automatically collects data at specified intervals
• Performs real-time quality control and validation
• Stores data in our PostgreSQL database
• Provides API access for data retrieval

Maintenance & Calibration

Regular maintenance schedules ensure optimal instrument performance:

• Daily: Automated system checks and data validation
• Weekly: Filter changes and basic cleaning
• Monthly: Calibration verification
• Quarterly: Full calibration and maintenance

Common Issues