.png)
.png){kind=link}
Unlock the full hardware potential of your smartphone.
SensorLab is an advanced, production-ready raw sensor data logger and physics toolbox built with Flutter. It seamlessly transforms consumer mobile devices into highly precise scientific tools for diagnostics, tracking, environmental logging, and STEM education.
🚀 Key Features • 📊 Use Cases • 🏗️ Architecture • 📚 Hardware Modules • ⚙️ Setup • 🤝 Contributing
Below is an overview of the core application layouts, highlighting the modern Material Design 3 configuration, live telemetry recording sessions, and real-time visualization dashboards.
Dashboard SensorLab Dashboard |
Sensor Multiplexing Toggle Active Hardware |
Lab Configuration Sampling Interval Controls |
Real-Time Execution Waveform & Lux Metrics |
Session Analytics Historical Log Details |
Speed & Kinematics Live GPS Speed Metrics |
- Modular Lab Builder: Custom-stack multiple hardware sensors inside an adaptive dashboard panel. Customize sampling frequencies down to the millisecond layer.
- Background Synchronous Logging: Write multiple stream outputs sequentially with complete pipeline background persistence.
- Clean Data Ingestion: Export entire tracking sessions instantly into cleanly formatted
.csvsheets or local SQLite dumps for instant processing in MATLAB, Python (Pandas), or Microsoft Excel. - Pre-Configured Environments: Includes ready-to-go environment packages such as the Vehicle Dynamics Lab (G-Force, acceleration, velocity) and Outdoor Explorer Lab (altimeter, compass, position).
- Dynamic Internationalization: Fully configured with over 500+ localized tracking strings supporting English, Spanish, Japanese, and Khmer out-of-the-box.
💡 Whether you're an engineer, automotive hobbyist, or research scientist, SensorLab simplifies raw hardware data acquisition.
- Automotive & Motorsports Testing: Leverage high-frequency accelerometer and gyroscope telemetry alongside GPS tracking to analyze braking, cornering thresholds, and real-time vehicle velocity vectors.
- Acoustic & Noise Pollution Mapping: Use the Decibel Noise Meter for environmental inspections, classroom noise leveling, and industrial safety compliance checks.
- Horticulture & Light Level Auditing: Track exact ambient lumens via the Lux Plant Light Meter to determine ideal growing positions for interior greenhouse setups.
- Academic STEM Research: An ideal open-source Physics Toolbox alternative for universities and high schools to perform kinematics, magnetic field detection, and location tracking experiments without expensive custom instrumentation.
| Hardware Target | Core Package Dependency | Primary Technical Application Target |
|---|---|---|
| Motion / Kinematics |
sensors_plus, flutter_sensors
|
3-Axis Accelerometer, Gyroscope angular rate, and Orientation matrices. |
| Location / Velocity |
geolocator, location
|
Galileo / GLONASS GPS coordinates, speed vectors, and offline altimeter readings. |
| Environment |
light_sensor, Native Streams |
Real-time ambient light monitoring (Lux) and proximity bounds detection. |
| Acoustic Sound |
flutter_sound, sound_level_meter
|
Sound pressure monitoring, waveform calculation, and |
| Navigation | sensors_plus |
Magnetometer-driven digital compass heading vectors and flux density. |
| Biometrics |
camera + Image Processing |
Frame-by-frame color variation monitoring via camera flash for heart-rate estimation. |
SensorLab leverages a highly decoupled, clean architecture built on Provider / Riverpod state management mechanics to ensure high-frequency UI updates don't compromise background data collection performance.
SensorLab/
├── lib/
│ ├── main.dart # App initialization & routing gate
│ ├── models/ # Pure immutable data payloads
│ │ ├── sensor_data.dart
│ │ └── session.dart
│ ├── providers/ # State management and UI dispatchers
│ │ ├── sensor_provider.dart
│ │ └── settings_provider.dart
│ ├── screens/ # Modular view layout layer
│ │ ├── home_screen.dart
│ │ └── dashboard_screen.dart
│ ├── services/ # Hardware access & business logic layer
│ │ ├── sensor_service.dart
│ │ └── csv_export_service.dart
│ └── widgets/ # Reusable, atomic UI elements
└── assets/
└── translations/ # Global localization maps (EN, ES, JA, KM)
- Framework: Flutter SDK
>=3.0.0| Dart SDK>=3.0.0 - Development Environment: Android Studio (latest) or Xcode (for iOS targets)
# Clone the repository
git clone [https://github.com/darahat-dev-Solutions/SensorLab.git](https://github.com/darahat-dev-Solutions/SensorLab.git)
# Navigate into the project root directory
cd SensorLab
# Install and link runtime dependencies
flutter pub get
Ensure your real hardware device or simulator target is properly mapped via flutter devices, then execute:
flutter run
We highly encourage contributions from developers, researchers, and localization experts!
- Fork the repository layer.
- Setup a feature branch:
git checkout -b feature/AmazingPerformanceUpgrade. - Keep logic clean, self-contained, and ensure all changes follow the Official Flutter Code Style Guide.
- Issue a Pull Request explaining the structural modification.
This framework codebase is distributed under the open-source MIT License. Check out the local LICENSE file for full compliance details.
⭐ If SensorLab made your research workflow easier, consider leaving us a GitHub Star!
Crafted with precision by Darahat Dev Solutions.