Skip to main content
Version: Traxis Camera Tracking 4.0

Automatic Lens Profiling

Objective​

Create a Lens File that maps zoom and focus values to the optical parameters required by the virtual camera. For a tracked camera, the workflow can also determine camera alignment and fixed Center Shift.

Stage 1 — Open Autoprofiler​

Open Lens → Autoprofiler or the equivalent release menu.

Confirm the Start checklist:

  • Camera enabled;
  • Live video;
  • Live tracked camera body;
  • Valid encoder;
  • Safe zoom/focus values.

Stage 2 — Choose the Task​

Select Profile a lens on a tracked camera for a new tracked-camera Lens File.

Workflow selection

Workflow selection stage; choose profiling or realignment according to what changed.

Do not choose Realign when the optical lens curve has never been created. Do not choose PTZ for a freely translated tracked camera.

Stage 3 — Configure the Lens​

  1. Select Zoom lens or Prime/Fixed lens.
  2. For a zoom lens, select the zoom interval:
    • 0.2 for six nominal levels;
    • 0.1 for eleven nominal levels and higher precision.
  3. Select the reference-marker method.
  4. Select Tag 1 and optionally Tag 2.
  5. Confirm that every readiness line is valid.

Reset the current lens calibration only when you intentionally want to discard the current profile state. On a tracked-camera profiling task, this can also clear tracked-camera alignment values.

Stage 4 — Configure Center Shift​

Center Shift describes movement of the optical center relative to the image center.

ModeUse case
NoneNo measurable fixed or zoom-dependent shift
Mount offsetFixed camera/lens mounting displacement
Zoom MechanismOptical center moves with zoom
BothFixed mounting displacement plus zoom-dependent movement

Use the mode selected by the approved workflow. Do not choose a mode only to make the warning disappear.

Detect at Wide​

  1. Select one configured marker.
  2. Set physical zoom to full wide.
  3. Pan/tilt until the complete target is approximately centered.
  4. Select Detect @Wide.
  5. Confirm corner detection.

Wide detection

Wide-end target detection during fixed Center Shift measurement.

Detect at Tele and Compute​

  1. Increase physical zoom while keeping the same target visible.
  2. Stop before the tag becomes clipped or too large for detection.
  3. Select Detect @Tele.
  4. Confirm corner detection.
  5. Select Compute.

Center Shift computation

Tele detection and computed Center Shift using the same reference target.

Wide and Tele captures are independent but must use the same video resolution. Return physical zoom to 0 before the profiling stage.

Stage 5 — Select the Wide Zoom Point​

Select zoom 0.0. Move the physical lens until the encoder is inside the wizard tolerance. The stage controls may remain hidden while the encoder is outside the selected zoom point.

The wide point is the most important point. It establishes the initial optical solution and, for tracked cameras, the camera-owned alignment that the task permits.

Stage 6 — Capture Samples​

Move the camera or change pan/tilt so the target appears in different frame areas. Stop and wait for stable capture after every movement.

Sample capture

Sample coverage indicators distributed across the image at the active zoom point.

Capture:

  • center samples;
  • left and right samples;
  • upper and lower samples;
  • corner samples;
  • near and far target observations when Nodal Offset is required.

Coverage is more important than a large count. Many samples from one small area do not constrain the lens correctly.

Every sample stores the 2D detection, 3D target position, tracked camera pose, zoom, and focus. Do not mix physical zoom levels in one sample set.

Stage 7 — Solve​

Select Automatic unless an expert has a specific reason to control parameters manually.

Automatic solve mode

Automatic Solve at the selected zoom point after sample capture.

  1. Confirm that at least one valid sample is enabled.
  2. Select Solve.
  3. Approve overwrite only if the current task is intended to replace stored values.
  4. Wait for the quality and projection-error result.
  5. Continue to detailed review before accepting.

For tracked-camera profiling, the wide solve can determine applicable camera offsets. Implementation guidance keeps Z fixed and solves the permitted X/Y and orientation components. At higher zoom points, the task solves optical curves rather than redefining the physical camera mount.

Stage 8 — Review and Accept​

Inspect minimum, maximum, and mean projection error. Magnify the viewport digitally and compare the observed target center with the projected 3D point.

Projection error

Projection-error review showing detected 2D target positions and projected 3D positions.

If one sample is much worse than the others, use Adjust Samples, disable only the confirmed outlier, and re-solve. Do not delete difficult edge samples merely to make the average smaller.

Stage 9 — Check Focus Breathing​

Place a target near an image edge. Change focus through the useful range. If the projected point moves relative to the target, select Yes, it changed, start adjustment, and align it using Fine/Medium/Coarse increments.

Focus Breathing correction

Focus-dependent framing correction after a successful optical solve.

Rack focus again. Complete the correction only when the target remains aligned through the checked focus range.

Stage 10 — Repeat for Every Zoom Point​

Move the physical lens to the next planned value and select/add that zoom level.

Add current zoom

Adding the next physical zoom level after completing the wide point.

Repeat:

  1. Capture Samples.
  2. Solve.
  3. Review Results.
  4. Focus Breathing.
  5. Correction.

Do not mark the full lens complete when only one or two zoom points are solved.

Stage 11 — Finish and Reveal the Lens File​

Finish only after every planned zoom point is complete.

Lens File profile

Generated Lens File opened in the profile/editor view after Autoprofiler completion.

Review the generated curves, save the project, and export the Lens File according to the site delivery process. Record the camera, lens make/model/serial, encoder, zoom interval, target method, date, and operator.