> For the complete documentation index, see [llms.txt](https://stage-precision.gitbook.io/grid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stage-precision.gitbook.io/grid/camera-calibration/reposition-workflows.md).

# Reposition Workflows

Reposition workflows are used when an existing calibration setup needs to be moved, adjusted, or updated without performing a full camera calibration again.

These tools are typically used after a Lens Profile, Alignment Profile, Camera Object, Calibration Screens, or Measurement Points already exist.

The general Calibration Object setup, Capture Window, capture process, and output handling are explained in the **Using the Calibration Object** section.

The pages in this section focus on workflow-specific best practices, requirements, outputs, and common mistakes.

{% hint style="info" %}
Use **Choosing the Right Calibration Tool** if you are not sure whether you need a full calibration workflow or a reposition workflow.
{% endhint %}

***

## What Reposition Workflows Are Used For

Reposition workflows help update parts of an existing setup.

They are useful when the physical setup has changed, but not every part of the calibration needs to be recreated.

### Moving an Existing Camera Setup

Some workflows can reposition an existing calibrated camera setup by applying an offset to a parent object or Folder.

This is useful when a calibrated system has been moved in the real world and needs to be aligned again in the Grid Studio project.

### Updating Calibration Screen Placement

Some workflows can update the placement, orientation, or shape of Calibration Screens.

This is useful when Calibration Screens have changed position or when new screens need to be aligned to an existing calibrated setup.

### Creating or Updating Alignment from Points

Some workflows can use points or image references to adjust the alignment of an existing camera setup.

This can be useful when the camera does not need a full lens calibration, but its alignment needs to be corrected.

***

## Workflow Categories

Reposition workflows can be grouped by what they update.

### Camera or Parent Repositioning

Use these workflows when a Camera Object, parent Folder, or complete calibrated setup needs to be moved in 3D space.

* **Reposition from Marker**
* **Reposition from Screen**

### Calibration Screen Repositioning

Use these workflows when Calibration Screens need to be positioned, updated, or aligned.

* **Screen Reposition Without Profile**
* **Screens Alignment**

### Alignment from Image Points

Use this workflow when an Alignment Profile should be created or adjusted from selected image points.

* **Focusing on Points**

***

## How to Use These Pages

Each workflow page explains:

* when to use the workflow
* when not to use it
* what the workflow updates
* required setup
* important Calibration Object settings
* capture or referencing strategy
* outputs
* best practices
* common mistakes

The workflow pages do not repeat every general UI step.

For detailed Calibration Object usage, see **Using the Calibration Object**.

***

## Reposition Workflow Overview

| Workflow                              | Main Purpose                                                                         |
| ------------------------------------- | ------------------------------------------------------------------------------------ |
| **Focusing on Points**                | Creates or adjusts an Alignment Profile using selected points in the camera image.   |
| **Reposition from Marker**            | Repositions an existing calibrated setup or parent object using Measurement Points.  |
| **Reposition from Screen**            | Repositions an existing calibrated setup or parent object using Calibration Screens. |
| **Screen Reposition Without Profile** | Positions or updates Calibration Screens without requiring an existing Lens Profile. |
| **Screens Alignment**                 | Updates Calibration Screen placement using an already calibrated camera setup.       |

***

## When to Use Reposition Workflows

Use a reposition workflow when you already have calibration data and only need to adjust part of the setup.

### Existing Calibration Was Moved

Use **Reposition from Marker** or **Reposition from Screen** when the calibrated camera setup has been moved and needs to be aligned again.

These workflows do not recreate the Lens Profile or Alignment Profile. Instead, they apply a transform offset to the selected parent object or Folder.

### Calibration Screens Need Updating

Use **Screen Reposition Without Profile** or **Screens Alignment** when Calibration Screens need to be positioned, updated, or aligned.

This can be useful when:

* screens have moved
* new screens were added
* screen placement was not measured accurately
* an existing calibrated camera can be used to align screens

### Alignment Needs Adjustment

Use **Focusing on Points** when an Alignment Profile should be adjusted from selected image points.

This can be useful when the lens is already calibrated, but the relationship between the image and camera alignment needs refinement.

***

## Important Notes

Reposition workflows are not replacements for full calibration workflows.

They are designed to update or move specific parts of an existing calibration setup.

### Existing Data May Be Required

Depending on the workflow, reposition tools may require existing data such as:

* Camera Object
* Lens Profile
* Alignment Profile
* Calibration Screens
* Measurement Points
* Parent Folder
* Media Input
* tracking maps

Check the individual workflow page before starting.

### Outputs Are Different

Reposition workflows usually do not create full Lens Profiles.

Depending on the tool, they may update:

* parent or object transform
* Alignment Profile
* Calibration Screen placement
* Calibration Screen shape or geometry

{% hint style="info" %}
Reposition workflows are useful when only part of the setup needs to change. If the lens, tracking system, or camera setup has changed significantly, a full calibration workflow may be required instead.
{% endhint %}

***

## Before Continuing Checklist

Before using a reposition workflow, check the following:

* You know which part of the setup should be updated.
* Existing Lens Profiles or Alignment Profiles are available if required.
* Calibration Screens or Measurement Points are prepared if required.
* The correct Camera Object or parent Folder is selected if required.
* The Media Input uses the raw camera image.
* Required maps are configured if the workflow needs tracking data.
* You understand whether the workflow updates profiles, screen placement, or object transforms.
* You have checked whether a full calibration workflow would be more appropriate.