# tszheichoi/awesome-sensor-logger architecture

> Architecture diagram of the GitHub repository tszheichoi/awesome-sensor-logger, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tszheichoi/awesome-sensor-logger
- Repository: https://github.com/tszheichoi/awesome-sensor-logger

## Overview

This repository is a documentation and resource companion for the Sensor Logger app, not the app implementation. Its principal workflow is to record smartphone or watch sensor measurements, export them, and analyze the resulting files. The README documents the workflow and analysis topics; the file tree also shows dedicated references for integrations and app capabilities. Source excerpts were unavailable, so the graph omits undocumented implementation-level wiring.

Main entry points: [`README.md`](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/README.md) (App and analysis guide), [`UNITS.md`](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/UNITS.md) (Units reference), [`COORDINATES.md`](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/COORDINATES.md) (Coordinates reference), [`SAMPLING.md`](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/SAMPLING.md) (Sampling reference)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Recording and analysis"]
  node_app["Sensor Logger app"]
  node_sensors["Phone and watch sensors"]
  node_recording["Sensor recording"]
  node_export["Recording exports"]
  node_analysis["Analysis tools"]
  node_readme["App and analysis guide<br/>[README.md]"]
end

subgraph group_guides["Data references"]
  node_units["Units reference<br/>[UNITS.md]"]
  node_coordinates["Coordinates reference<br/>[COORDINATES.md]"]
  node_sampling["Sampling reference<br/>[SAMPLING.md]"]
  node_depth["Depth reference<br/>[DEPTH.md]"]
  node_fused["Fused location reference<br/>[FUSEDLOCATION.md]"]
  node_microphone["Microphone reference<br/>[MICROPHONE.md]"]
  node_orientation["Orientation reference<br/>[ORIENTATION.md]"]
  node_video["Video reference<br/>[VIDEO.md]"]
  node_crossplatform["Cross-platform guide<br/>[CROSSPLATFORM.md]"]
end

subgraph group_integrations["App integrations"]
  node_study["Study API<br/>[STUDY_API.md]"]
  node_delivery["Study data delivery"]
  node_webhooks["Study webhooks<br/>[STUDY_WEBHOOKS.md]"]
  node_backups["Backups API<br/>[BACKUPS_API.md]"]
  node_deep["Deep links<br/>[DEEP_LINKS.md]"]
  node_questionnaire["Questionnaires<br/>[QUESTIONNAIRE.md]"]
  node_push["Push notifications<br/>[PUSHING.md]"]
end

node_user(("Logger user"))

node_user -->|"records with"| node_app
node_sensors -->|"supply readings"| node_app
node_app -->|"records measurements"| node_recording
node_app -->|"exports as"| node_export
node_export -->|"analyzed with"| node_analysis
node_readme -->|"describes"| node_app
node_readme -->|"guides"| node_analysis
node_readme -->|"references"| node_units
node_readme -->|"references"| node_coordinates
node_readme -->|"references"| node_sampling
node_readme -->|"references"| node_crossplatform
node_readme -->|"covers"| node_depth
node_readme -->|"covers"| node_fused
node_readme -->|"covers"| node_microphone
node_readme -->|"covers"| node_orientation
node_readme -->|"covers"| node_video

click node_readme "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/README.md"
click node_units "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/UNITS.md"
click node_coordinates "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/COORDINATES.md"
click node_sampling "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/SAMPLING.md"
click node_depth "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/DEPTH.md"
click node_fused "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/FUSEDLOCATION.md"
click node_microphone "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/MICROPHONE.md"
click node_orientation "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/ORIENTATION.md"
click node_video "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/VIDEO.md"
click node_crossplatform "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/CROSSPLATFORM.md"
click node_study "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/STUDY_API.md"
click node_delivery "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/STUDY_DATA_DELIVERY.md"
click node_webhooks "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/STUDY_WEBHOOKS.md"
click node_backups "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/BACKUPS_API.md"
click node_deep "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/DEEP_LINKS.md"
click node_questionnaire "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/QUESTIONNAIRE.md"
click node_push "https://github.com/tszheichoi/awesome-sensor-logger/blob/main/PUSHING.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_sensors,node_recording,node_export,node_analysis,node_readme,node_user toneBlue
class node_units,node_coordinates,node_sampling,node_depth,node_fused,node_microphone,node_orientation,node_video,node_crossplatform toneAmber
class node_study,node_delivery,node_webhooks,node_backups,node_deep,node_questionnaire,node_push toneMint
```

## Components

### Recording and analysis

- **Sensor Logger app**
- **Phone and watch sensors**
- **Sensor recording**
- **Recording exports**
- **Analysis tools**
- [App and analysis guide](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/README.md): `README.md`

### Data references

- [Units reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/UNITS.md): `UNITS.md`
- [Coordinates reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/COORDINATES.md): `COORDINATES.md`
- [Sampling reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/SAMPLING.md): `SAMPLING.md`
- [Depth reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/DEPTH.md): `DEPTH.md`
- [Fused location reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/FUSEDLOCATION.md): `FUSEDLOCATION.md`
- [Microphone reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/MICROPHONE.md): `MICROPHONE.md`
- [Orientation reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/ORIENTATION.md): `ORIENTATION.md`
- [Video reference](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/VIDEO.md): `VIDEO.md`
- [Cross-platform guide](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/CROSSPLATFORM.md): `CROSSPLATFORM.md`

### App integrations

- [Study API](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/STUDY_API.md): `STUDY_API.md`
- [Study data delivery](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/STUDY_DATA_DELIVERY.md): `STUDY_DATA_DELIVERY.md`
- [Study webhooks](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/STUDY_WEBHOOKS.md): `STUDY_WEBHOOKS.md`
- [Backups API](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/BACKUPS_API.md): `BACKUPS_API.md`
- [Deep links](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/DEEP_LINKS.md): `DEEP_LINKS.md`
- [Questionnaires](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/QUESTIONNAIRE.md): `QUESTIONNAIRE.md`
- [Push notifications](https://github.com/tszheichoi/awesome-sensor-logger/blob/main/PUSHING.md): `PUSHING.md`

### Other components

- **Logger user**

## Connections

- Logger user → Sensor Logger app: records with
- Phone and watch sensors → Sensor Logger app: supply readings
- Sensor Logger app → Sensor recording: records measurements
- Sensor Logger app → Recording exports: exports as
- Recording exports → Analysis tools: analyzed with
- App and analysis guide → Sensor Logger app: describes
- App and analysis guide → Analysis tools: guides
- App and analysis guide → Units reference: references
- App and analysis guide → Coordinates reference: references
- App and analysis guide → Sampling reference: references
- App and analysis guide → Cross-platform guide: references
- App and analysis guide → Depth reference: covers
- App and analysis guide → Fused location reference: covers
- App and analysis guide → Microphone reference: covers
- App and analysis guide → Orientation reference: covers
- App and analysis guide → Video reference: covers