Integrated Biomechanics

Integrated into Technical Reports

Biomechanics analysis is now integrated directly into technical reports. When you include occupant data in your CreateReport request for a technical report, biomechanics analysis is automatically computed as part of the report.

There is no separate biomechanics API - simply add occupants to your technical report request.

How It Works

When creating a technical report, include the occupants field to enable integrated biomechanics analysis:

Go

import silentwitness "github.com/silentwitness/sw-go-sdk"

client := silentwitness.NewClient(silentwitness.Config{
    APIKey: os.Getenv("SW_API_KEY"),
})
defer client.Close()

// Create technical report WITH biomechanics
response, err := client.CreateReport(ctx, &silentwitness.CreateReportParams{
    CaseID: "case_xyz789",
    Type:   silentwitness.ReportTypeTechnicalReport,
    Plaintiff: &silentwitness.VehicleDataParams{
        ImageFileIds: plaintiffFileIDs,
        VehicleMaker: silentwitness.String("Toyota"),
        VehicleModel: silentwitness.String("Camry"),
        VehicleYear:  silentwitness.String("2020"),
    },
    AccidentDescription: silentwitness.String("Rear-end collision at stoplight"),
    AccidentDate:        silentwitness.String("2024-03-15"),

    // Include occupants for integrated biomechanics analysis
    Occupants: []silentwitness.OccupantDataParams{
        {
            Name:         silentwitness.String("Sarah Johnson"),
            Age:          silentwitness.Int32(42),
            Gender:       silentwitness.String("female"),
            HeightInches: silentwitness.Int32(65),
            WeightLbs:    silentwitness.Int32(150),
            Position:     silentwitness.String("driver"),
            AllegedInjuries: []string{
                "cervical_spine",
                "lumbar_spine",
            },
            InjurySeverity:        silentwitness.String("moderate"),
            PreExistingConditions: silentwitness.String("Prior lumbar disc herniation"),
            SeatbeltWorn:          silentwitness.Bool(true),
            AirbagDeployed:        silentwitness.String("no"),
        },
    },
})
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Report ID: %s\n", response.ReportID)

TypeScript

import { SilentWitnessClient } from "@silentwitness/sdk";

const client = new SilentWitnessClient({
    apiKey: process.env.SW_API_KEY
});

// Create technical report WITH biomechanics
const response = await client.createReport({
    caseId: "case_xyz789",
    type: "technical_report",
    plaintiff: {
        imageFileIds: plaintiffFileIds,
        vehicleMaker: "Toyota",
        vehicleModel: "Camry",
        vehicleYear: "2020"
    },
    accidentDescription: "Rear-end collision at stoplight",
    accidentDate: "2024-03-15",

    // Include occupants for integrated biomechanics analysis
    occupants: [{
        name: "Sarah Johnson",
        age: 42,
        gender: "female",
        heightInches: 65,
        weightLbs: 150,
        position: "driver",
        allegedInjuries: [
            "cervical_spine",
            "lumbar_spine"
        ],
        injurySeverity: "moderate",
        preExistingConditions: "Prior lumbar disc herniation",
        seatbeltWorn: true,
        airbagDeployed: "no"
    }]
});

console.log(`Report ID: ${response.reportId}`);

OccupantData Structure

Each occupant requires the following information:

API Field	SDK Field	Type	Required	Description
name	Name	string	No	Occupant name
age	Age	int32	Yes	Age in years (1-120)
gender	Gender	string	Yes	"male", "female", or "other"
height_inches	HeightInches	int32	No	Height in inches (e.g., 70 for 5'10")
weight_lbs	WeightLbs	int32	No	Weight in pounds
position	Position	string	Yes	Seating position (see below)
alleged_injuries	AllegedInjuries	string[]	Yes	At least 1 injury type required
injury_severity	InjurySeverity	string	No	"minor", "moderate", "serious", "severe", "critical"
pre_existing_conditions	PreExistingConditions	string	No	Pre-existing medical conditions
seatbelt_worn	SeatbeltWorn	boolean	No	Seatbelt usage (default: true)
airbag_deployed	AirbagDeployed	string	No	Airbag status: "yes", "no", "partial", "unknown"

Position Values

• driver - Driver seat
• front_passenger - Front passenger seat
• rear_left - Rear left seat
• rear_center - Rear center seat
• rear_right - Rear right seat

Injury Type Values

• head_brain - Traumatic brain injury, concussion
• cervical_spine - Neck injuries, whiplash
• thoracic_spine - Upper back injuries
• lumbar_spine - Lower back injuries
• shoulder - Shoulder injuries
• hip - Hip injuries
• knee - Knee injuries
• foot_ankle - Foot and ankle injuries

Multiple Occupants

You can include up to 10 occupants in a single request:

Go

Occupants: []silentwitness.OccupantDataParams{
    {
        Name:            silentwitness.String("Driver"),
        Age:             silentwitness.Int32(45),
        Gender:          silentwitness.String("male"),
        Position:        silentwitness.String("driver"),
        AllegedInjuries: []string{"cervical_spine", "lumbar_spine"},
    },
    {
        Name:            silentwitness.String("Passenger"),
        Age:             silentwitness.Int32(38),
        Gender:          silentwitness.String("female"),
        Position:        silentwitness.String("front_passenger"),
        AllegedInjuries: []string{"shoulder", "knee"},
    },
},

What's Included in the Report

When occupants are included, the technical report contains:

• Crash Analysis: Delta-V, PDOF, impact classification
• Biomechanical Forces: Forces experienced by each occupant
• Injury Causation: Analysis of how crash forces relate to claimed injuries
• Pre-existing Condition Assessment: How prior conditions affect injury risk

Next Steps

• Technical Report API - Full API reference
• Get Results - Check status and download PDF