U h~8@sddlmZddlZddlmZmZmZddlZddl m Z m Z ddl m Z mZddd d d d d gZddddddhZdddddZGdd d eZGdd d e ZddddddZddddddd Zd'dd"ddddd#d$d Zd(dd"ddddd%d&d ZdS))) annotationsN)AnyLiteralSequence)'NUM_KEYPOINTS_COLUMNS_IN_ALBUMENTATIONSPAIR) DataProcessorParamsangle_to_2pi_rangecheck_keypoints%convert_keypoints_from_albumentations#convert_keypoints_to_albumentationsfilter_keypointsKeypointsProcessorKeypointParamsxyyxxyaxysxyasxysa np.ndarray)anglesreturncCst|dtjS)N)npmodpi)rrG/tmp/pip-unpacked-wheel-e8onvpoz/albumentations/core/keypoints_utils.pyr scsteZdZdZdddddddfdd Zd d fd d Zedd ddZedd ddZdd ddZ Z S)raParameters of keypoints Args: format (str): format of keypoints. Should be 'xy', 'yx', 'xya', 'xys', 'xyas', 'xysa'. x - X coordinate, y - Y coordinate s - Keypoint scale a - Keypoint orientation in radians or degrees (depending on KeypointParams.angle_in_degrees) label_fields (list): list of fields that are joined with keypoints, e.g labels. Should be same type as keypoints. remove_invisible (bool): to remove invisible points after transform or not angle_in_degrees (bool): angle in degrees or radians in 'xya', 'xyas', 'xysa' keypoints check_each_transform (bool): if `True`, then keypoints will be checked after each dual transform. Default: `True` NTstrzSequence[str] | Noneboolformat label_fieldsremove_invisibleangle_in_degreescheck_each_transformcs$t||||_||_||_dSN)super__init__r&r'r()selfr$r%r&r'r( __class__rr r+3szKeypointParams.__init__dict[str, Any]rcs&t}||j|j|jd|S)N)r&r'r()r*to_dict_privateupdater&r'r()r,datar-rr r1@s zKeypointParams.to_dict_privatecCsdS)NTrclsrrr is_serializableKszKeypointParams.is_serializablecCsdS)Nrrr4rrr get_class_fullnameOsz!KeypointParams.get_class_fullnamec Cs.d|jd|jd|jd|jd|jd S)NzKeypointParams(format=z, label_fields=z, remove_invisible=z, angle_in_degrees=z, check_each_transform=)r#r,rrr __repr__Ss,zKeypointParams.__repr__)NTTT) __name__ __module__ __qualname____doc__r+r1 classmethodr6r7r: __classcell__rrr-r rs  cseZdZddddfdd Zeddd d Zd d d ddZddddddZddd dddZddddddZ ddddddZ Z S)rNrzdict[str, str] | None)paramsadditional_targetscst||dSr))r*r+)r,rArBr-rr r+\szKeypointsProcessor.__init__r!r0cCsdS)N keypointsrr9rrr default_data_name_sz$KeypointsProcessor.default_data_namer/None)r3rcs2|jjr.tfdd|jjDs.d}t|dS)Nc3s|]}|kVqdSr)r).0ir3rr dsz7KeypointsProcessor.ensure_data_valid..zaYour 'label_fields' are not valid - them must have same names as params in 'keypoint_params' dict)rAr%all ValueError)r,r3msgrrHr ensure_data_validcs"z$KeypointsProcessor.ensure_data_validrtuple[int, int])r3 image_shapercCs|t|||jjdS)N)r&)rrAr&r,r3rOrrr filterhszKeypointsProcessor.filtercCst||dSr))r rPrrr checklszKeypointsProcessor.checkcCs(|js |S|j}t||j||j|jdSN)check_validityr')sizerAr r$r&r'r,r3rOrArrr convert_from_albumentationsosz.KeypointsProcessor.convert_from_albumentationscCs(|js |S|j}t||j||j|jdSrS)rUrArr$r&r'rVrrr convert_to_albumentationssz,KeypointsProcessor.convert_to_albumentations)N) r;r<r=r+propertyrDrMrQrRrWrXr@rrr-r r[srNrE)rCrOrcsD|dd\dddfdddftdkkBs^tdkkBrtdkkBdtdkkBd}g}fddttt|BD}td|jdtkr@dddftdkdt j kBd}t |dkr@fdd|D}td|dS) uCheck if keypoint coordinates are within valid ranges for the given image shape. This function validates that: 1. All x-coordinates are within [0, width) 2. All y-coordinates are within [0, height) 3. If angles are present (i.e., keypoints have more than 2 columns), they are within the range [0, 2π) Args: keypoints (np.ndarray): Array of keypoints with shape (N, 2+), where N is the number of keypoints. Each row represents a keypoint with at least (x, y) coordinates. If present, the third column is assumed to be the angle. image_shape (Tuple[int, int]): The shape of the image (height, width). Raises: ValueError: If any keypoint coordinate is outside the valid range, or if any angle is invalid. The error message will detail which keypoints are invalid and why. Note: - The function assumes that keypoint coordinates are in absolute pixel values, not normalized. - Angles, if present, are assumed to be in radians. - The constant PAIR should be defined elsewhere in the module, typically as 2. Nrrrc sZg|]R}d|krdndd|d|kr2nd|krH|n|d qS)z Expected xy for keypoint z to be in the range [0.0, z], got .rrFidx)height invalid_xrCwidthrZr[rr sz#check_keypoints.. cs$g|]}d|d|qS)z2Keypoint angle must be in range [0, 2 * PI). Got: r\rr^)rrCrr rcs) ranywheresortedsetrKjoinshapermathrlen)rCrOZ invalid_yZerror_messagesZinvalid_anglesr)rr`rarCrbrZr[r r s$",  r")rCrOr&rcCsl|s|S|js|S|dd\}}|dddf|dddf}}|dk||k@|dk@||k@}||S)aFilter keypoints to remove those outside the image boundaries. Args: keypoints: A numpy array of shape (N, 2+) where N is the number of keypoints. Each row represents a keypoint (x, y, ...). image_shape: A tuple (height, width) representing the image dimensions. remove_invisible: If True, remove keypoints outside the image boundaries. Returns: A numpy array of filtered keypoints. Nrrr)rU)rCrOr&r`rbrZr[Zvisiblerrr rs" FTz3Literal[('xy', 'yx', 'xya', 'xys', 'xyas', 'xysa')])rC source_formatrOrTr'rc CsR|tkrtd|dtddddgddddgddddgddddgddddgddddgd}||}tj|jdtftjd }t|D],\}} | dk r|dd| f|dd|f<q|r|ddk rt|dddf|dddf<t |dddf|dddf<|jdt |kr>t ||ddt |dff}|rNt |||S) uConvert keypoints from various formats to the Albumentations format. This function takes keypoints in different formats and converts them to the standard Albumentations format: [x, y, angle, scale]. If the input format doesn't include angle or scale, these values are set to 0. Args: keypoints (np.ndarray): Array of keypoints with shape (N, 2+), where N is the number of keypoints. The number of columns depends on the source_format. source_format (Literal["xy", "yx", "xya", "xys", "xyas", "xysa"]): The format of the input keypoints. - "xy": [x, y] - "yx": [y, x] - "xya": [x, y, angle] - "xys": [x, y, scale] - "xyas": [x, y, angle, scale] - "xysa": [x, y, scale, angle] image_shape (tuple[int, int]): The shape of the image (height, width). check_validity (bool, optional): If True, check if the converted keypoints are within the image boundaries. Defaults to False. angle_in_degrees (bool, optional): If True, convert input angles from degrees to radians. Defaults to True. Returns: np.ndarray: Array of keypoints in Albumentations format [x, y, angle, scale] with shape (N, 4+). Any additional columns from the input keypoints are preserved and appended after the first 4 columns. Raises: ValueError: If the source_format is not one of the supported formats. Note: - Angles are converted to the range [0, 2π) radians. - If the input keypoints have additional columns beyond what's specified in the source_format, these columns are preserved in the output. zUnknown source_format . Supported formats are: rrNrrrrrrr)Zdtype) keypoint_formatsrKrzerosrjrZfloat32 enumerateradiansr rl column_stackr ) rCrmrOrTr'Zformat_to_indicesindicesZprocessed_keypointsrGr_rrr rs,*       " " )rC target_formatrOrTr'rc Cs|tkrtd|dt|dddf|dddf|dddf|dddff\}}}}t|}|rtt||||f||rt|}||g||g|||g|||g||||g||||gd} t| |} |jdtkrt| |ddtdffS| S) uConvert keypoints from Albumentations format to various other formats. This function takes keypoints in the standard Albumentations format [x, y, angle, scale] and converts them to the specified target format. Args: keypoints (np.ndarray): Array of keypoints in Albumentations format with shape (N, 4+), where N is the number of keypoints. Each row represents a keypoint [x, y, angle, scale, ...]. target_format (Literal["xy", "yx", "xya", "xys", "xyas", "xysa"]): The desired output format. - "xy": [x, y] - "yx": [y, x] - "xya": [x, y, angle] - "xys": [x, y, scale] - "xyas": [x, y, angle, scale] - "xysa": [x, y, scale, angle] image_shape (tuple[int, int]): The shape of the image (height, width). check_validity (bool, optional): If True, check if the keypoints are within the image boundaries. Defaults to False. angle_in_degrees (bool, optional): If True, convert output angles to degrees. If False, angles remain in radians. Defaults to True. Returns: np.ndarray: Array of keypoints in the specified target format with shape (N, 2+). Any additional columns from the input keypoints beyond the first 4 are preserved and appended after the converted columns. Raises: ValueError: If the target_format is not one of the supported formats. Note: - Input angles are assumed to be in the range [0, 2π) radians. - If the input keypoints have additional columns beyond the first 4, these columns are preserved in the output. - The constant NUM_KEYPOINTS_COLUMNS_IN_ALBUMENTATIONS should be defined elsewhere in the module, typically as 4. zUnknown target_format rnNrrrrorp) rqrKr r rrudegreesrjr) rCrwrOrTr'rZr[ZangleZscaleZformat_to_columnsresultrrr r 4s&-D    )FT)FT) __future__rrktypingrrrZnumpyrZalbumentations.core.typesrrutilsr r __all__rqr rrr rrr rrrr s2  >67$P