i= *SrSSKrSSKrSSKJrJrJrJr SS\RS\\\ \ \ \ 4S\ S\\ \ 44Sjjr S\RS\\ \ \ \ 4S\\ \\\44S jrSS\\ \ \ \ 4S \ S \ S\ 4S jjrSS \ S\ S\ 4SjjrS\S\ 4SjrS\RS\\ \ \ \ 4S \ S\S\\ \44 SjrS\RS\RS\ 4SjrSS\\RS\ S\\ \ \\ 44SjjrS\RS\\\ \ \ \ 44Sjrg)zb Image Quality Validation Service Provides comprehensive validation for face registration images. N)TupleListDictOptionalimage face_bbox thresholdreturnc[R"U[R5nU(aUupEpgX5XW-2XDU-24n[R"U[R5R 5nX:n X4$)aI Detect blur using Laplacian variance method. Args: image: Input image (BGR format) face_bbox: Optional face bounding box (x, y, w, h). If None, uses entire image. threshold: Minimum variance threshold (default: 80 - more lenient, focuses on face clarity) Returns: Tuple of (is_blurry: bool, blur_score: float) )cv2cvtColorCOLOR_BGR2GRAY LaplacianCV_64Fvar) rrr grayxywh laplacian_var is_blurrys 6/var/www/fran/franai/services/image_quality_service.py detect_blurr sp <<s11 2D aacE1qS5L!MM$ 3779M)I  ##c[R"U[R5nUup4pVXXF-2X3U-24n[R"U[R5n[[R "U55n [R "US:R[55n URn [X- 5n [[R "U55n [[R"U55n[[R"U55n[[R"U55n[UU- 5n[[R "US:H5UR- 5n[[R "US:H5UR- 5n[R"UR[S9nSUXDU-2X3U-24'UUn[!U5S:a[[R "U55OU nSnUU U-:n[R "US:R[55n[UUR- 5n[R "US:R[55n[UUR- 5nU UUUUUUUUU U UUX- S .n/nU S :aUR#S 5 OU S:aUR#S 5 U S :aUR#S5 U S :aUR#S5 OU S:aUR#S5 US:aUR#S5 US:aUR#S5 U(aUS:aUR#S5 US:aUR#S5 US:aUR#S5 US:aUR#S5 XS-:aUR#S5 US:aUR#S5 [!U5S:HUU4$)z Comprehensive lighting validation for both face region and overall environment. Args: image: Input image (BGR format) face_bbox: Face bounding box (x, y, w, h) Returns: Tuple of (is_valid: bool, issues: List[str], metrics: Dict) r)dtypeFF)face_mean_brightnessface_brightness_stdface_min_brightnessface_max_brightness face_contrastface_clipped_darkface_clipped_brightface_very_bright_percentageface_moderate_bright_percentageenv_brightnessenv_glare_percentagebackground_brightness is_backlitbrightness_diff<environment_too_darkenvironment_too_brightQ?excessive_glare face_too_darkface_too_bright333333?(backlit low_contrast皙? underexposed333333? overexposed uniform_lighting)r r rfloatnpmeansumastypeintsizestdminmaxonesshapeboollenappend)rr gray_fullrrrr face_region gray_facer,env_glare_pixelsenv_total_pixelsr-r#r$r%r&r'r(r)maskbackground_regionr.backlight_thresholdr/face_very_bright_pixelsr*face_moderate_bright_pixelsr+metricsissuess rvalidate_lightingr^%s UC$6$67IJA!!#q1u %K [#*<*<=I2779-.Nvvy366s;< ~~ !1!DE!!34y 12bffY/0bffY/0+.AABMbffY!^4y~~EFyC'7 89>> IJ 779??$ /DDQ3A#!$ADEVAWZ[A[E"''*;"<=ao &)=@S)SSJ!ffi#o%=%=c%BC"'(?)..(P"Q#%&&)c/)A)A#)F"G&+,G)..,X&Y#!5222&.2'B+J( 4!6 /@G"F  ,- #  ./d" '( b  o&  # '(S  '(#T) '( 2  MM) $r n%4 n%T! m$r11 '( R () v;! VW ,,rmin_size ideal_sizecNUu p4n[XE5nXa:agXb:agXa- X!- - $)a Calculate score based on face size. Larger faces are generally better for recognition. Args: face_bbox: Face bounding box (x, y, w, h) min_size: Minimum acceptable face size ideal_size: Ideal face size Returns: Score between 0.0 and 1.0 ?)rK)rr_r`_rr face_sizes rcalculate_face_size_scorerfs=JAqQA I  $)>??r blur_scorecHXS-:agX:aX- U- $[SX- 5$)z Convert blur score to sharpness score (0.0 to 1.0). Args: blur_score: Laplacian variance score threshold: Minimum acceptable threshold Returns: Score between 0.0 and 1.0 rcrb)rL)rgr s rcalculate_sharpness_scorerjs7]"  &)333 .//rr\cSnURSS5nUS:dUS:aUS-nOUS:dUS:aUS -nURS S 5nUS :aUS -nO US:aUS-nURSS5nUS:dUS:aUS-nOUS:dUS:aUS -nURSS5nUS:aUS -nURSS 5nUS:aUS -nO US:aUS-nXBS-:aUS-nURSS5(aUS-nURSS5nUS:aUS -nO US:aUS-nURS S!5S:aUS -nURS"S!5S#:aUS-nURS$S5S%:aUS -nU$)&z Calculate lighting quality score from lighting metrics. Args: metrics: Dictionary from validate_lighting() Returns: Score between 0.0 and 1.0 rcr,r1r"r8P333333?r-rbr4g?g{Gz?gffffff?r#Zr&r*r=r?g?r/Fr'd2r(rr)g?r$)get)r\scorer, env_glareface_brightnessr&face_very_bright_pctcontrasts r calculate_lighting_quality_scorer~s E[[!137Nns2   "  4   2C8I4   T   kk"8#>O4   2 3!6  "++&;SAS   #;;'DcJd"    $  ",,  {{<''  {{?C0H"}   B  {{&*T1  {{(!,t3  {{("-2   Lrlighting_metricsc[U5n[U5n[U5nSSSSS.nSnUUUUS.n U SUS-U SUS--U SUS--U SUS--n U UUUUS .n X4$) a* Calculate overall quality score for an image. Args: image: Input image (BGR format) face_bbox: Face bounding box (x, y, w, h) blur_score: Blur score from detect_blur() lighting_metrics: Metrics from validate_lighting() Returns: Tuple of (total_score: float, breakdown: Dict) r8r=) sharpnessrelighting face_anglercrrerr)totalrrerr)rjrfr~) rrrgrrrerweightsrscores total_score breakdowns rcalculate_quality_scorer)s**5I))4I/0@AH GJ F {gk22{gk22 3zWZ00 1 |w|44 5 I  !!r embedding1 embedding2c[R"X5n[RRU5n[RRU5nUS:XdUS:XagX#U-- $)z Calculate cosine similarity between two embeddings. Args: embedding1: First embedding vector embedding2: Second embedding vector Returns: Cosine similarity score between -1.0 and 1.0 (typically 0.0 to 1.0 for face embeddings) rrb)rDdotlinalgnorm)rr dot_productnorm1norm2s rcosine_similarityr`sS&&0K IINN: &E IINN: &E zUaZ %- ((r embeddingsc[U5S:aSS/4$USn/nSn[USSSS9H3upV[X&5n[XG5nXq:dM"UR U5 M5 [U5S:HXC4$)a% Validate that all embeddings are from the same person by comparing to first embedding. Args: embeddings: List of embedding vectors threshold: Minimum cosine similarity threshold (default: 0.6) Returns: Tuple of (is_valid: bool, min_similarity: float, failed_indices: List[int]) riTrcrN)start)rP enumeraterrKrQ)rr referencefailed_indicesmin_similarityi embedding similaritys rvalidate_embedding_consistencyrus :S"}1 INN!*QR.: &y< ^8  !  ! !! $ ; ~ ! #^ CCrc [R"U[R5n[R"[RR S-5nUR USS5n[U5S:Xag[USS9n[U5$)z Detect face in image using OpenCV Haar Cascade. Args: image: Input image (BGR format) Returns: Face bounding box (x, y, w, h) or None if no face detected z#haarcascade_frontalface_default.xmlg?rNcUSUS-$)Nri)fs r&detect_face_in_image..sAaD1Q4Kr)key) r r rCascadeClassifierdata haarcascadesdetectMultiScalerPrLtuple)rr face_cascadefaces largest_faces rdetect_face_in_imagersv <<s11 2D(()>)>Af)fgL  ) )$Q 7E 5zQu"78L  r)NT@)rmr")r)ro)__doc__r numpyrDtypingrrrrndarrayrHrCrOrstrr^rfrjr~rrrrrrrrs ..$rzz$huS#sC=O7P.Q$ej$v{}ACH}HwI$6J-RZZJ-E#sC:L4MJ-RWX\^bcf^gimXmRnJ-Z@sCc/A)B@c@dg@rw@20%0E0U0*FdFuFR4"2::4"%S#s@R:S4"',4"@D4"INuVZ{I[4"n)"**)"**))*DtBJJ/?DED\abfhmostwoxbx\yD6 xc3S>P8Q/Rr