user: Describe MovieTrackingTrack(bpy_struct) from the Blender manual or Python API, including usage steps and snippets.

assistant: # MovieTrackingTrack(bpy_struct)

base class — [`bpy_struct`](bpy.types.bpy_struct.html#bpy.types.bpy_struct "bpy.types.bpy_struct")

*class* bpy.types.MovieTrackingTrack(*bpy_struct*)
:   Match-moving track data for tracking

    annotation
    :   Annotation data for this track

        Type:
        :   [`Annotation`](bpy.types.Annotation.html#bpy.types.Annotation "bpy.types.Annotation")

    average_error
    :   Average error of re-projection

        Type:
        :   float in [-inf, inf], default 0.0, (readonly)

    bundle
    :   Position of bundle reconstructed from this track

        Type:
        :   [`mathutils.Vector`](mathutils.html#mathutils.Vector "mathutils.Vector") of 3 items in [-inf, inf], default (0.0, 0.0, 0.0), (readonly)

    color
    :   Color of the track in the Movie Clip Editor and the 3D viewport after a solve

        Type:
        :   [`mathutils.Color`](mathutils.html#mathutils.Color "mathutils.Color") of 3 items in [0, 1], default (0.0, 0.0, 0.0)

    correlation_min
    :   Minimal value of correlation between matched pattern and reference that is still treated as successful tracking

        Type:
        :   float in [0, 1], default 0.0

    frames_limit
    :   Every tracking cycle, this number of frames are tracked

        Type:
        :   int in [0, 32767], default 0

    has_bundle
    :   True if track has a valid bundle

        Type:
        :   boolean, default False, (readonly)

    hide
    :   Track is hidden

        Type:
        :   boolean, default False

    lock
    :   Track is locked and all changes to it are disabled

        Type:
        :   boolean, default False

    margin
    :   Distance from image boundary at which marker stops tracking

        Type:
        :   int in [0, 300], default 0

    markers
    :   Collection of markers in track

        Type:
        :   [`MovieTrackingMarkers`](bpy.types.MovieTrackingMarkers.html#bpy.types.MovieTrackingMarkers "bpy.types.MovieTrackingMarkers") [`bpy_prop_collection`](bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection "bpy.types.bpy_prop_collection") of [`MovieTrackingMarker`](bpy.types.MovieTrackingMarker.html#bpy.types.MovieTrackingMarker "bpy.types.MovieTrackingMarker"), (readonly)

    motion_model
    :   Default motion model to use for tracking

        - `Perspective`
          Perspective – Search for markers that are perspectively deformed (homography) between frames.
        - `Affine`
          Affine – Search for markers that are affine-deformed (t, r, k, and skew) between frames.
        - `LocRotScale`
          Location, Rotation & Scale – Search for markers that are translated, rotated, and scaled between frames.
        - `LocScale`
          Location & Scale – Search for markers that are translated and scaled between frames.
        - `LocRot`
          Location & Rotation – Search for markers that are translated and rotated between frames.
        - `Loc`
          Location – Search for markers that are translated between frames.

        Type:
        :   enum in [`'Perspective'`, `'Affine'`, `'LocRotScale'`, `'LocScale'`, `'LocRot'`, `'Loc'`], default `'Loc'`

    name
    :   Unique name of track

        Type:
        :   string, default “”, (never None)

    offset
    :   Offset of track from the parenting point

        Type:
        :   [`mathutils.Vector`](mathutils.html#mathutils.Vector "mathutils.Vector") of 2 items in [-inf, inf], default (0.0, 0.0)

    pattern_match
    :   Track pattern from given frame when tracking marker to next frame

        - `KEYFRAME`
          Keyframe – Track pattern from keyframe to next frame.
        - `PREV_FRAME`
          Previous frame – Track pattern from current frame to next frame.

        Type:
        :   enum in [`'KEYFRAME'`, `'PREV_FRAME'`], default `'KEYFRAME'`

    select
    :   Track is selected

        Type:
        :   boolean, default False

    select_anchor
    :   Track’s anchor point is selected

        Type:
        :   boolean, default False

    select_pattern
    :   Track’s pattern area is selected

        Type:
        :   boolean, default False

    select_search
    :   Track’s search area is selected

        Type:
        :   boolean, default False

    use_alpha_preview
    :   Apply track’s mask on displaying preview

        Type:
        :   boolean, default False

    use_blue_channel
    :   Use blue channel from footage for tracking

        Type:
        :   boolean, default False

    use_brute
    :   Use a brute-force translation only pre-track before refinement

        Type:
        :   boolean, default False

    use_custom_color
    :   Use custom color instead of theme-defined

        Type:
        :   boolean, default False

    use_grayscale_preview
    :   Display what the tracking algorithm sees in the preview

        Type:
        :   boolean, default False

    use_green_channel
    :   Use green channel from footage for tracking

        Type:
        :   boolean, default False

    use_mask
    :   Use a Grease Pencil data-block as a mask to use only specified areas of pattern when tracking

        Type:
        :   boolean, default False

    use_normalization
    :   Normalize light intensities while tracking (slower)

        Type:
        :   boolean, default False

    use_red_channel
    :   Use red channel from footage for tracking

        Type:
        :   boolean, default False

    weight
    :   Influence of this track on a final solution

        Type:
        :   float in [0, 1], default 0.0

    weight_stab
    :   Influence of this track on 2D stabilization

        Type:
        :   float in [0, 1], default 0.0

    *classmethod* bl_rna_get_subclass(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The RNA type or default when not found.

        Return type:
        :   [`bpy.types.Struct`](bpy.types.Struct.html#bpy.types.Struct "bpy.types.Struct") subclass

    *classmethod* bl_rna_get_subclass_py(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The class or default when not found.

        Return type:
        :   type