FgNSSKJr SSKrSSKJr SSKJrJrJrJrJ r SSK r SSK r SSK JrJrJr SSKJrJr SSKJr \(aSSKJr /S Qr\"S 5r\"S \ R4S 9r\"S \S\4S 9rSSjrSSjrSSjrSSjr SSjr!SSjr""SS5r#SSjr$g)) annotationsNwraps) TYPE_CHECKINGAnyCallableTypeVarcast)is_grayscale_imageis_multispectral_image is_rgb_image) Concatenate ParamSpec)angle_to_2pi_range)Path)angle_2pi_range non_rgb_errorread_bgr_imageread_grayscaleread_rgb_imagePT)boundF.c^[R"[U5[R5$N)cv2imreadstr IMREAD_COLORpaths s/Users/admin/workspace/ai/PDFMathTranslate/myenv/lib/python3.13/site-packages/albumentations/augmentations/utils.pyrr#s ::c$i!1!1 22cb[U5n[R"U[R5$r)rrcvtColor COLOR_BGR2RGB)r"images r#rr's# 4 E <<s00 11r$c^[R"[U5[R5$r)rrrIMREAD_GRAYSCALEr!s r#rr,s ::c$i!5!5 66r$c4^[T5SU4Sjj5nU$)Nc>T"U/UQ70UD6n[U5S:a,URSS:a[USS2S45USS2S4'U$)Nr)lenshaper) keypointsargskwargsresultfuncs r#wrapped_function)angle_2pi_range..wrapped_function3sPi1$1&1 v;?v||A2-fQTl;F1a4L r$)r1 np.ndarrayr2zP.argsr3zP.kwargsreturnr8r)r5r6s` r#rr0s# 4[ r$c[U5(d7Sn[U5(aUS- n[U5(aUS- n[U5eg)aCheck if the input image is RGB and raise a ValueError if it's not. This function is used to ensure that certain transformations are only applied to RGB images. It provides helpful error messages for grayscale and multi-spectral images. Args: image (np.ndarray): The input image to check. Expected to be a numpy array representing an image. Raises: ValueError: If the input image is not an RGB image (i.e., does not have exactly 3 channels). The error message includes specific instructions for grayscale images and a note about incompatibility with multi-spectral images. Note: - RGB images are expected to have exactly 3 channels. - Grayscale images (1 channel) will trigger an error with conversion instructions. - Multi-spectral images (more than 3 channels) will trigger an error stating incompatibility. Example: >>> import numpy as np >>> rgb_image = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8) >>> non_rgb_error(rgb_image) # No error raised >>> >>> grayscale_image = np.random.randint(0, 256, (100, 100), dtype=np.uint8) >>> non_rgb_error(grayscale_image) # Raises ValueError with conversion instructions >>> >>> multispectral_image = np.random.randint(0, 256, (100, 100, 5), dtype=np.uint8) >>> non_rgb_error(multispectral_image) # Raises ValueError stating incompatibility z,This transformation expects 3-channel imagesz[ You can convert your grayscale image to RGB using cv2.cvtColor(image, cv2.COLOR_GRAY2RGB))z? This transformation cannot be applied to multi-spectral imagesN)r r r ValueError)r(messages r#rr=sP>   @ e $ $ u uG !% ( ( Y YG!! r$c ^^[UU4SjU55(d[SUSTSTS35eUSUS::d[U<SU35eg ) aChecks if the given value is within the specified bounds Args: value: The value to check and convert. Can be a single float or a tuple of floats. lower_bound: The lower bound for the range check. upper_bound: The upper bound for the range check. name: The name of the parameter being checked. Used for error messages. Raises: ValueError: If the value is outside the bounds or if the tuple values are not ordered correctly. c3N># UHnTUs=:*=(a T:*Os v M g7fr).0x lower_bound upper_bounds r# check_range..rs!>1{a..;..s"%zAll values in z must be within [z, z] for tuple inputs.rr-z2 tuple values must be ordered as (min, max). Got: N)allr;)valuerBrCnames `` r# check_rangerIfsg >> > >>$/@ RP[}\opqq 8uQx D8#UV[U\]^^ r$c^\rSrSrS S SjjrS SjrSSjrSSjrSSjrSSjr SS jr S r g)PCAxNcbUbUS::a [S5eXlSUlSUlSUlg)Nrz/Number of components must be greater than zero.)r; n_componentsmean components_explained_variance_)selfrNs r#__init__ PCA.__init__ys8  # (9NO O('+ .26: r$cUR[R5nURup#URc[ X#5Ul[ R"USURS9uUlpEX@l UR5Ul g)N)rO maxComponents) astypenpfloat64r0rNminr PCACompute2rOrPflattenrQ)rRrA n_samples n_features eigenvectors eigenvaluess r#fitPCA.fitsr HHRZZ  !     $ #I :D /2qt[_[l[l/m, <'#.#6#6#8 r$cURc [S5eUR[R5n[ R "XRUR5$NzgThis PCA instance is not fitted yet. Call 'fit' with appropriate arguments before using this estimator.)rPr;rWrXrYr PCAProjectrOrRrAs r# transform PCA.transformsP    #U  HHRZZ ~~aD,<,<==r$cFURU5 URU5$r)rargrfs r# fit_transformPCA.fit_transforms  ~~a  r$cURc [S5e[R"XRUR5$rd)rPr;rPCABackProjectrOrfs r#inverse_transformPCA.inverse_transforms@    #U !!!YY0@0@AAr$cURc [S5e[R"UR5nURU- $)NzdThis PCA instance is not fitted yet. Call 'fit' with appropriate arguments before using this method.)rQr;rXsum)rRtotal_variances r#explained_variance_ratioPCA.explained_variance_ratiosE  # # +v  8 89''.88r$cJ[R"UR55$r)rXcumsumrs)rRs r##cumulative_explained_variance_ratio'PCA.cumulative_explained_variance_ratiosyy66899r$)rPrQrOrNr)rNz int | Noner9None)rAr8r9ry)rAr8r9r8)r9r8) __name__ __module__ __qualname____firstlineno__rSrargrjrnrsrw__static_attributes__r?r$r#rKrKxs&; 9>!B9:r$rKc^SU4SjjnU$)Ncj>^[R"T5SUU4Sjj5n[[U5$)Nc>[U5S:aUSnOTU;aUTnO[ST35e[U5S:XaU$T"U0UD6$)NrzMissing required argument: )r/r;)r2r3arrayr5 param_names r#wrapper6handle_empty_array..decorator..wrappers^4y1}Qv%z* #>zl!KLL5zQ (( (r$)r2rr3rr9r) functoolsrr r)r5rrs` r# decorator%handle_empty_array..decorators-   )  )Awr$)r5rr9rr?)rrs` r#handle_empty_arrayrs $ r$)r"z str | Pathr9r8)r50Callable[Concatenate[np.ndarray, P], np.ndarray]r9r)r(r8r9ry) rGztuple[float, float]rBfloatrCrrHz str | Noner9ry)rrr9zCallable[[F], F])% __future__rrrtypingrrrr r rnumpyrXalbucore.utilsr r r typing_extensionsrr#albumentations.core.keypoints_utilsrpathlibr__all__rndarrayrrrrrrrrIrKrr?r$r#rs">>  5B cN Crzz" CxS)*32 7  : 5 &"R_$3:3:lr$