codekingpro/portable-devtools
115k
1�
2 v�j � �H � S SK Jr S SKrS SKJr SSKJr " S S5 r\rg)� )� annotationsN)�cached_property� )�Imagec �� � \ rS rSr S SS jjr\SS j5 r\SS j5 r\SS j5 r\SS j5 r \SS j5 r3\SS j5 r \SS4 j5 r \SS j5 r
\SS j5 rS
rg)�Stat� Nc � � [ U[ R 5 ( a UR U5 U l O)[ U[ 5 ( a Xl O
Sn[ U5 e[ [
[ U R 5 S- 5 5 U l g)a� 5Calculate statistics for the given image. If a mask is included,6only the regions covered by that mask are included in the7statistics. You can also pass in a previously calculated histogram.8 9:param image: A PIL image, or a precalculated histogram.10 11 .. note::12 13 For a PIL image, calculations rely on the14 :py:meth:`~PIL.Image.Image.histogram` method. The pixel counts are15 grouped into 256 bins, even if the image has more than 8 bits per16 channel. So ``I`` and ``F`` mode images have a maximum ``mean``,17 ``median`` and ``rms`` of 255, and cannot have an ``extrema`` maximum18 of more than 255.19 20:param mask: An optional mask.21z$first argument must be image or list� N) �22isinstancer � histogram�h�list� TypeError�range�len�bands)�self�
image_or_list�mask�msgs �SD:\code\apps\devtools\python\user_packages\Python313\site-packages\PIL/ImageStat.py�__init__�
Stat.__init__ sf � �* �m�U�[�[� 1� 1�"�,�,�T�2�D�F�
�
�t�
,�
,�"�F�8�C��C�.� ��%��D�F�F� �s� 2�3�4��23� c � � SS jn[ S[ U R 5 S5 Vs/ s H o!" U R US 5 PM sn$ s snf )a% 24Min/max values for each band in the image.25 26.. note::27 This relies on the :py:meth:`~PIL.Image.Image.histogram` method, and28 simply returns the low and high bins used. This is correct for29 images with 8 bits per channel, but fails for other modes such as30 ``I`` or ``F``. Instead, use :py:meth:`~PIL.Image.Image.getextrema` to31 return per-band extrema for the image. This is more correct and32 efficient because, for non-8-bit modes, the histogram method uses33 :py:meth:`~PIL.Image.Image.getextrema` to determine the bins used.34c � � Su p[ S5 H nX ( d M Un O [ SSS5 H nX ( d M Un X4$ X4$ )N)�� r r r �����)r )r
�res_min�res_max�is r �minmax� Stat.extrema.<locals>.minmaxM s_ � � %� �G��3�Z�� �<�<� �G�� � �3��B�'�� �<�<� �G���#� #� (� �#� #r r r N)r
� list[int]�returnztuple[int, int])r r r )r r# r" s r �extrema� Stat.extrema> sC � � 35 $� -2�!�S����[�#�,F�G�,F�q��t�v�v�a�b�z�"�,F�G�G��Gs � A c � � [ S[ U R 5 S5 Vs/ s H n[ U R XS- 5 PM sn$ s snf )z2Total number of pixels for each band in the image.r r )r r r �sum�r r" s r �count�36Stat.count[ sA � � 38��3�t�v�v�;��2L�M�2L�Q��D�F�F�1�3�w�'�(�2L�M�M��Ms �$A37c �� � / n[ S[ U R 5 S5 H> nSn[ S5 H nX4U R X$- - -
nM UR U5 M@ U$ )z-Sum of all pixels for each band in the image.r r � )r r r �append)r �vr" � layer_sum�js r r* �Stat.sum` sa � �
���q�#�d�f�f�+�s�+�A��I��3�Z�������� � .�.� � �
�H�H�Y� � ,�38 �r c �� � / n[ S[ U R 5 S5 HJ nSn[ S5 H% nX4S- [ U R X$- 5 - -
nM' UR U5 ML U$ )z5Squared sum of all pixels for each band in the image.r r r/ � )r r r �floatr0 )r r1 r" �sum2r3 s r r8 � Stat.sum2l si � �
���q�#�d�f�f�+�s�+�A��D��3�Z���A���t�v�v�a�e�}�!5�5�5�� �
�H�H�T�N� ,�39 �r c � � U R Vs/ s H7 oR U ( a U R U U R U - OSPM9 sn$ s snf )zAAverage (arithmetic mean) pixel level for each band in the image.r )r r, r* r+ s r �mean� Stat.meanx sD � � NR�Z�Z�X�Z��z�z�!�}����� �d�j�j��m�+�!�C�Z�X�X��Xs �>Ac �� � / nU R HY nSnU R U S- nUS- n[ S5 H nX0R XV- - nX4:� d M O UR W5 M[ U$ )z.Median pixel level for each band in the image.r r6 r )r r, r r r0 )r r1 r" �s�half�br3 s r �median� Stat.median} ss � �
�����A��A��:�:�a�=�A�%�D��C��A��3�Z�����q�u�
�%���8�� �
�H�H�Q�K� � �r c �� � U R Vs/ s HL nU R U ( a3 [ R " U R U U R U - 5 OSPMN sn$ s snf )z2RMS (root-mean-square) for each band in the image.r )r r, �math�sqrtr8 r+ s r �rms�Stat.rms� sZ � �40 �Z�Z�41� �� 8<�z�z�!�}�D�I�I�d�i�i��l�T�Z�Z��]�2� 3�!� K� �42� 43�� 44s �AA%c �� � U R Vs/ s H[ nU R U ( aB U R U U R U S- U R U - -45 U R U - OSPM] sn$ s snf )z$Variance for each band in the image.g @r )r r, r8 r* r+ s r �var�Stat.var� s{ � � �Z�Z�
46� �� �:�:�a�=� ���1� ����!���!3�t�z�z�!�}� D�D��47�48�ST�
�U��� �
49� 50�� 51s �A"A4c � � U R Vs/ s H& n[ R " U R U 5 PM( sn$ s snf )z.Standard deviation for each band in the image.)r rD rE rI r+ s r �stddev� Stat.stddev� s1 � � 15�52�53�;�54�1�� � �$�(�(�1�+�&�55�;�;��;s �-?)r r )N)r zImage.Image | list[int]r zImage.Image | Noner& �None)r& zlist[tuple[int, int]])r& r% )r& z list[float])�__name__�56__module__� __qualname__�__firstlineno__r r r' r, r* r8 r; rA rF rI rL �__static_attributes__� r r r r s� � �QU� 5� 4� 5�<N� 5�
� 5�< �H� �H�8 �N� �N� � � � � � � � � �Y� �Y� �
� �
� �57� �58� � 59� � 60� �<� �<r r ) �61__future__r rD � functoolsr � r r �GlobalrT r r �<module>rY s' ��. #� � %� �E<� E<�P 62�r