> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ochy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Example videos

> Sample input and output videos for each analysis type -- back view and side view, overground and treadmill.

Reference videos showing what to film (input) and what the analysis produces (output) for each combination of analysis type and running condition.

## Video requirements at a glance

Every video sent to the API must meet the general constraints below. **Orientation varies by analysis type** -- see the per-scenario tables further down.

| Constraint    | Requirement                                                       |
| ------------- | ----------------------------------------------------------------- |
| Format        | MP4, MOV, AVI, or WEBM                                            |
| Max duration  | 10 seconds                                                        |
| Max file size | 30 MB                                                             |
| Resolution    | 1080p recommended (max 1080p height)                              |
| Frame rate    | 30 fps minimum, 60 fps recommended                                |
| Framing       | Runner clearly visible and occupying a large portion of the frame |

### Orientation by scenario

| Analysis type | Condition                      | Orientation          | Typical resolution |
| ------------- | ------------------------------ | -------------------- | ------------------ |
| Side view     | Overground (`treadmill=false`) | **Landscape** (16:9) | 1920 x 1080        |
| Side view     | Treadmill (`treadmill=true`)   | **Portrait** (9:16)  | 1080 x 1920        |
| Back view     | Overground (`treadmill=false`) | **Portrait** (9:16)  | 1080 x 1920        |
| Back view     | Treadmill (`treadmill=true`)   | **Portrait** (9:16)  | 1080 x 1920        |

<Warning>
  Submitting a video with the wrong orientation for a given analysis type will produce
  poor results or cause the analysis to fail. Double-check the table above before uploading.
</Warning>

***

<Tabs>
  <Tab title="Side view">
    Camera is positioned to the side of the runner. Set `analysis_type=side_view`.

    ### Overground

    `treadmill=false`

    | Property           | Requirement                                                                       |
    | ------------------ | --------------------------------------------------------------------------------- |
    | Orientation        | **Landscape** (width > height)                                                    |
    | Typical resolution | 1920 x 1080                                                                       |
    | Duration           | Up to 10 s                                                                        |
    | Framing            | Full body visible from head to feet, runner moving left-to-right or right-to-left |

    <Tabs>
      <Tab title="Input">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_input%2Fside_view%2Foverground.mp4?alt=media&token=2ce61112-f357-4d17-aeb9-10699fa99eb3" />
      </Tab>

      <Tab title="Output">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_output%2Fside_view%2Fanalysis_sideView.mp4?alt=media&token=0c529fbc-66f9-41d4-a062-1da6d113a9b5" />
      </Tab>
    </Tabs>

    ### Treadmill

    `treadmill=true`

    | Property           | Requirement                                                              |
    | ------------------ | ------------------------------------------------------------------------ |
    | Orientation        | **Portrait** (height > width)                                            |
    | Typical resolution | 1080 x 1920                                                              |
    | Duration           | Up to 10 s                                                               |
    | Framing            | Full body visible from head to feet, camera at the side of the treadmill |

    <Tabs>
      <Tab title="Input">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_input%2Fside_view%2Fretail_side_view_treadmill.mp4?alt=media&token=00c09e8b-6bd7-4746-aa18-2802fcf6a1c3" />
      </Tab>

      <Tab title="Output">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_output%2Fside_view%2Fanalysis_sideView_retail_store.mp4?alt=media&token=dd1ef176-dafd-41c9-9509-1a0e505095fb" />
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Back view">
    Camera is positioned behind the runner. Set `analysis_type=back_view`.

    ### Overground

    `treadmill=false`

    | Property           | Requirement                                                         |
    | ------------------ | ------------------------------------------------------------------- |
    | Orientation        | **Portrait** (height > width)                                       |
    | Typical resolution | 1080 x 1920                                                         |
    | Duration           | Up to 10 s                                                          |
    | Framing            | Full body visible from head to feet, runner moving away from camera |

    <Tabs>
      <Tab title="Input">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_input%2Fback_view%2Fretail_back_view_overground.mp4?alt=media&token=dbe7a571-0f0f-4ad3-829d-9df974d0ab9c" />
      </Tab>

      <Tab title="Output">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/exemple%2Fanalysis%2Fde%2Foutput%2Fanalysis_backView_overground_de.mp4?alt=media" />
      </Tab>
    </Tabs>

    ### Treadmill

    `treadmill=true`

    | Property           | Requirement                                                      |
    | ------------------ | ---------------------------------------------------------------- |
    | Orientation        | **Portrait** (height > width)                                    |
    | Typical resolution | 1080 x 1920                                                      |
    | Duration           | Up to 10 s                                                       |
    | Framing            | Full body visible from head to feet, camera behind the treadmill |

    <Tabs>
      <Tab title="Input">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_input%2Fback_view%2Fretail_back_view_treadmill.mp4?alt=media&token=1f2e84b0-381d-4c90-9965-6d45f31cf820" />
      </Tab>

      <Tab title="Output">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_output%2Fback_view%2Fanalysis_backView_retail_store.mp4?alt=media&token=a8301b59-1903-472f-bd33-eb3f3a2b2267" />
      </Tab>
    </Tabs>

    ### Treadmill -- lower body only

    `treadmill=true` with `full_body=false`

    | Property           | Requirement                                                |
    | ------------------ | ---------------------------------------------------------- |
    | Orientation        | **Portrait** (height > width)                              |
    | Typical resolution | 1080 x 1920                                                |
    | Duration           | Up to 10 s                                                 |
    | Framing            | Lower body from waist to feet, camera behind the treadmill |

    <Tabs>
      <Tab title="Input">
        <video controls className="w-full aspect-video rounded-xl" src="https://firebasestorage.googleapis.com/v0/b/ochy-7871a.appspot.com/o/assets%2Fexample_analysis%2Fvideo_input%2Fback_view%2Fretail_back_view_lower_body.mp4?alt=media&token=f753867c-fcb0-4c85-8160-e38a2c464360" />
      </Tab>
    </Tabs>
  </Tab>
</Tabs>