Report Plot Generation

Actigraphy Importer

The repository now includes a local actigraphy importer for GGIR day-summary CSVs.

• Enter the development shell with nix develop
• Initialize the local database with python3 -m src.cli.import_actigraphy init-db
• Rebuild the actigraphy schema after incompatible changes with psql -f db/migrations/reset-actigraphy-db.sql "$ACTIGRAPHY_DB_URL"
• Import data with python3 -m src.cli.import_actigraphy import

The importer defaults to the hardcoded derivatives root in src/act/importer.py. If you want to load another study tree with the same path structure after derivatives/, update DEFAULT_DERIVATIVES_ROOT or pass --root /path/to/other/derivatives/... at runtime.

Local PostgreSQL Helpers

Start a repo-local PostgreSQL instance:

nix develop -c bash scripts/start-local-db.sh

Stop it:

nix develop -c bash scripts/stop-local-db.sh

Create a compressed local backup for transfer to another computer:

nix develop -c bash scripts/backup-local-db.sh

Restore a transferred backup into the local Postgres instance:

nix develop -c bash scripts/restore-local-db.sh /path/to/backup.dump

The transfer workflow is documented in docs/db-transfer-plan.md.