# Digital Twin Test Sequence Tool

This tool simulates camera tester sequences in a digital twin environment for camera intrinsic calibration.
It creates a virtual camera testing scenario with controlled motion sequences, lighting conditions, and 
calibration targets.

## Overview

The script provides an automated camera calibration sequence simulation that:
- Loads a camera tester scene from Omniverse
- Creates a custom perspective camera with specific positioning
- Executes predefined motion sequences for camera calibration
- Controls the sequence of target lights

## Motion Data Options

| Option | Description | Use Case |
|--------|-------------|----------|
| `tester_log` | Real tester log data (default) | Production calibration sequences |
| `manual_poses` | Predefined calibration target positions | Standard calibration workflows |
| `debug` | Simple debug motion | Testing and development |

## Usage

### Basic Command

```bash
cd kit/source/python/sensors/tests/validation
./run.sh ../../tools/cam/calibration/digital_twin_test_sequence.py --motion_data tester_log
```

### Command Line Arguments

| Argument | Type | Default | Description |
|----------|------|---------|-------------|
| `--motion_data` | str | `tester_log` | Motion data source (tester_log, manual_poses, debug) |

## Output

- **Viewport (Perspective Camera)**: Shows the motion of the virtual tester and the illumination of targets 
  according to the selected motion data in real time
