uoapi 0.1.0

A robust Python client for interacting with the Newcastle Urban Observatory API (v1.1). This package provides a comprehensive interface for accessing and analyzing urban sensor data with built-in caching, configuration management, and data analysis capabilities.

Urban Observatory API Client

A robust Python client for interacting with the Newcastle Urban Observatory API (v1.1). This package provides a comprehensive interface for accessing and analyzing urban sensor data with built-in caching, configuration management, and data analysis capabilities. Pacakge documentation, installation instructions and examples can be found at TODO

Key Features

• Flexible Configuration: Support for YAML-based configuration and runtime parameter updates
• Intelligent Caching: Built-in caching system with customizable retention periods
• Comprehensive Data Access:
  • Sensor metadata retrieval
  • Raw sensor data access
  • Theme and variable information
  • Spatial and temporal filtering
• Error Handling: Robust error handling and logging
• Data Analysis Tools: JSON structure analysis and data formatting utilities
• DataFrame Export: Easy conversion of metadata to Pandas DataFrames

Use Cases

• Urban data analysis
• Environmental monitoring
• Research and data collection
• Smart city applications
• Sensor network analysis

Technical Highlights

• Type-hinted for modern Python development
• Decorator-based caching system
• Dataclass-driven configuration
• Pandas integration for data manipulation
• Comprehensive logging system
• RESTful API interaction with request retry handling The package is designed for researchers, data scientists, and developers working with urban sensor data, providing a clean and intuitive interface to the Urban Observatory's extensive sensor network.