AI-powered conversational assistant that makes oceanographic data accessible through natural language. Instead of wrestling with complex data portals, technical interfaces, and NetCDF formats, simply ask questions like "Show me warm water profiles near Madagascar in 2023" and get immediate answers with visualizations.
# Oceanographic Data Analysis Chatbot: Technical Documentation
---
UI Demo - FloatChat
----
## Table of Contents
1. System Overview
2. Architecture Design
3. Stage 1: Natural Language Processing
4. Stage 2: Data Fetching
5. Stage 3: TableLLM Analysis
6. Stage 4: OceanGPT Interpretation
7. Stage 5: Visualization
8. Orchestration and Security
9. API Documentation
10. Implementation Guidelines
---
## System Overview
The Oceanographic Data Analysis Chatbot implements a **five-stage agentic pipeline** that transforms natural language queries into comprehensive oceanographic analyses. The system processes user questions through specialized AI models, retrieves and analyzes Argo float data, and generates scientific interpretations with interactive visualizations.
### Core Pipeline Flow
```
Natural Language Query → SQL/Pandas Code → Data Retrieval → TableLLM Analysis → OceanGPT Interpretation → Visualizations
```
### Key Features
- **Multi-modal AI Integration**: Combines TableLLM, OceanGPT, and visualization-specific models
- **Comprehensive Data Access**: Supports multiple data sources from local databases to remote APIs
- **Scientific Rigor**: Implements quality control, provenance tracking, and verification loops
- **Interactive Outputs**: Generates both static and interactive visualizations with downloadable code
---
## Architecture Design
### High-Level Architecture
The system follows a **microservices approach** with five distinct processing stages:
1. **Natural Language Processing**: Intent classification and query translation
2. **Data Fetching**: Multi-source data retrieval and standardization
3. **Numeric Analysis**: TableLLM-powered statistical analysis
4. **Domain Interpretation**: OceanGPT oceanographic expertise
5. **Visualization**: Interactive plot generation and presentation
### Technology Stack
**Core AI Models:**
- **TableLLM**: Specialized tabular data analysis
- **OceanGPT**: Domain-specific oceanographic interpretation
- **GPT-4/Text-to …