Objects.spaces.range space.range space

​

RangeClassificationOverlapStrategy

​

RangeSpace Objects

class RangeSpace(Space[_RangeObjectAnnotation, _GlobalClassificationAnnotation,
                       RangeClassificationOverlapStrategy])

​

put_object_instance

def put_object_instance(object_instance: ObjectInstance,
                        ranges: Ranges | Range,
                        *,
                        on_overlap: RangeOverlapStrategy = "error",
                        created_at: Optional[datetime] = None,
                        created_by: Optional[str] = None,
                        last_edited_at: Optional[datetime] = None,
                        last_edited_by: Optional[str] = None,
                        confidence: Optional[float] = None,
                        manual_annotation: Optional[bool] = None) -> None

• object_instance - The object instance to add to the space.
• ranges - Time ranges where the object should appear. Can be:
  • A single Range object (Range)
  • A list of Range objects for multiple ranges (List[Range])
• on_overlap - Strategy for handling existing annotations on overlapping ranges.
  • “error” (default): Raises an error if annotation already exists on overlapping ranges.
  • “merge”: Adds the object to new ranges while keeping existing annotations.
  • “replace”: Removes object from existing ranges before adding to new ranges.
• created_at - Optional timestamp when the annotation was created.
• created_by - Optional identifier of who created the annotation.
• last_edited_at - Optional timestamp when the annotation was last edited.
• last_edited_by - Optional identifier of who last edited the annotation.
• confidence - Optional confidence score for the annotation (0.0 to 1.0).
• manual_annotation - Optional flag indicating if this was manually annotated.

• LabelRowError - If ranges are invalid or if annotation already exists when on_overlap=“error”.

​

remove_object_instance_from_range

def remove_object_instance_from_range(object_instance: ObjectInstance,
                                      ranges: Ranges | Range) -> Ranges

• object_instance - The object instance to remove from ranges.
• ranges - Ranges to remove the object from. Can be:
  • A single Range object (Range)
  • A list of Range objects for multiple ranges (List[Range])

• Ranges - List of ranges where the object was actually removed. Empty if the object didn’t exist on any of the specified ranges.

​

put_classification_instance

def put_classification_instance(
        classification_instance: ClassificationInstance,
        *,
        on_overlap: Optional[RangeClassificationOverlapStrategy] = "error",
        created_at: Optional[datetime] = None,
        created_by: Optional[str] = None,
        last_edited_at: Optional[datetime] = None,
        last_edited_by: Optional[str] = None,
        confidence: Optional[float] = None,
        manual_annotation: Optional[bool] = None) -> None

• classification_instance - The classification instance to add to the space.
• on_overlap - Strategy for handling existing classifications.
  • “error” (default): Raises an error if classification of the same ontology item already exists.
  • “replace”: Overwrites existing classifications.
• created_at - Optional timestamp when the annotation was created.
• created_by - Optional identifier of who created the annotation.
• last_edited_at - Optional timestamp when the annotation was last edited.
• last_edited_by - Optional identifier of who last edited the annotation.
• confidence - Optional confidence score for the annotation (0.0 to 1.0).
• manual_annotation - Optional flag indicating if this was manually annotated.

• LabelRowError - If classification already exists when on_overlap=“error”.

​

remove_object_instance

def remove_object_instance(object_hash: str) -> Optional[ObjectInstance]

• object_hash - The hash identifier of the object instance to remove.

• Optional[ObjectInstance] - The removed object instance, or None if the object wasn’t found.

​

remove_classification_instance

def remove_classification_instance(
        classification_hash: str) -> Optional[ClassificationInstance]

• classification_hash - The hash identifier of the classification instance to remove.

• Optional[ClassificationInstance] - The removed classification instance, or None if the classification wasn’t found.