modelhealth 0.4.1

Python SDK for biomechanical analysis from smartphone videos

Model Health Python SDK

Python SDK for the Model Health biomechanical analysis API.

Installation

pip install modelhealth

Requires Python 3.11 or later.

Quick Start

import time
from modelhealth import (
    ModelHealthService,
    ActivityStatus,
    ActivityStatusUploading,
    AnalysisStatus,
)

service = ModelHealthService("your_api_key")

# List sessions created via the mobile app
sessions = service.session_list()
session = sessions[0]

# Get activities for a subject
subjects = service.subject_list()
activities = service.activities_for_subject(
    str(subjects[0].id), start_index=0, count=20
)
activity = activities[0]

# Poll until processing is complete
status = service.activity_status(activity)
while isinstance(status, ActivityStatusUploading) or status == ActivityStatus.processing:
    time.sleep(10)
    status = service.activity_status(activity)

# Run analysis
task = service.start_analysis("gait", activity, session)
analysis_status = service.analysis_status(task)
while analysis_status == AnalysisStatus.processing:
    time.sleep(10)
    analysis_status = service.analysis_status(task)

# Download results
import json
results = service.analysis_data_for_activity(activity, ["metrics"])
metrics = json.loads(results[0].data)

Documentation

Full documentation: docs.modelhealth.io

License

Apache 2.0