a
    yn„fD«  ã                   @  sB  U d dl mZ d dlZd dlZd dlmZmZmZmZm	Z	m
Z
 d dlmZmZ d dlZd dlmZ d dlmZmZmZ d dlmZmZ d dlmZ d d	lmZ d d
lmZ d dlm Z  d dl!m"Z" d dl#m$Z$ d dl%m&Z&m'Z' d dl(m)Z)m*Z* d dl+m,Z,m-Z- d dl.m/Z/m0Z0 d dl1m2Z2 d dl3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z= d dl>m?Z? d dl@mAZA d dlBmCZCmDZD e4�r´d dl#mEZE d dl1mFZF d dlGmHZH d dlImJZJ d dlKmLZL e' M¡ ZNe$ M¡ ZOdZPdeQd< dZRdeQd < G d!d"„ d"e9ƒZSG d#d$„ d$e=ƒZTG d%d&„ d&e=ƒZUG d'd(„ d(e=ƒZVG d)d*„ d*eƒZWed+d,œd-d.„ƒZXdS )/é    )ÚannotationsN)ÚCallableÚIterableÚMappingÚMutableMappingÚSequenceÚSized)ÚComplexÚReal)ÚBackend)Ú
backend_ofÚregister_backend_lookup_factoryÚregularize_backend)Úget_array_classÚget_record_class)ÚKernelError)Úwrap_layout)ÚMeta)Ú	to_nplike)Únplike_of_obj)ÚNumpy)Ú	IndexTypeÚNumpyMetadata)Ú	ShapeItemÚunknown_length)Úparameters_are_equalÚtype_parameters_equal)Úis_integer_likeÚis_sized_iterable)Únormalize_slice)
ÚTYPE_CHECKINGÚAnyÚAxisMaybeNoneÚJSONMappingÚLiteralÚProtocolÚSelfÚSupportsIndexÚ	TypeAliasÚ	TypedDict)ÚUNSET)ÚForm)ÚIndexÚIndex64)Ú	NumpyLike)Ú	SliceItem)ÚIndexedOptionArray)Ú
NumpyArray)ÚRegularArrayz×Callable[
    [
        Content,
        int,
        dict | None,
        dict | None,
        Callable[[], None],
        dict | None,
        NumpyLike | None,
        dict[str, Any],
    ],
    Content | None,
]r(   Ú
ActionTypezD
float | int | str | list[JSONValueType] | dict[str, JSONValueType]
ÚJSONValueTypec                
   @  s*   e Zd Zdddddddddd	œ	d
d„ZdS )ÚImplementsApplyActionÚContentÚintúMapping[str, Any] | NonezCallable[[], Content]zMapping | Noner   ÚApplyActionOptionsúContent | None)	ÚlayoutÚdepthÚdepth_contextÚlateral_contextÚcontinuationÚbehaviorÚbackendÚoptionsÚreturnc          	      C  s   d S ©N© )	Úselfr;   r<   r=   r>   r?   r@   rA   rB   rE   rE   ú[/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/awkward/contents/content.pyÚ__call__N   s    zImplementsApplyAction.__call__N)Ú__name__Ú
__module__Ú__qualname__rH   rE   rE   rE   rG   r5   M   s   r5   c                   @  sF   e Zd ZU ded< ded< ded< ded< ded< ded< ded	< d
S )r9   ÚboolÚallow_recordsZkeep_parametersZnumpy_to_regularZregular_to_jaggedZreturn_simplifiedZreturn_arrayú
str | NoneÚfunction_nameN©rI   rJ   rK   Ú__annotations__rE   rE   rE   rG   r9   \   s   
r9   c                   @  s>   e Zd ZU ded< ded< ded< ded< ded< ded< d	S )
ÚRemoveStructureOptionsrL   Zflatten_recordsÚstrrO   Z
drop_nonesÚkeepdimsrM   Zlist_to_regularNrP   rE   rE   rE   rG   rR   f   s   
rR   c                   @  sN   e Zd ZU ded< ded< ded< ded< ded< ded< ded	< ded
< dS )ÚToArrowOptionsrL   Ú	list_to32Ústring_to32Úbytestring_to32znp.dtype | NoneÚemptyarray_toÚcategorical_as_dictionaryÚextensionarrayÚcount_nullsÚrecord_is_scalarNrP   rE   rE   rE   rG   rU   o   s   
rU   c                
   @  sì  e Zd Zdddœdd„Zeddœdd„ƒZed	dœd
d„ƒZ�dddd	dœdd„Zdd	dœdd„Zeddœdd„ƒZ	�ddddœdd„Z
dddœd d!„Zdd"œd#d$„Zdd"œd%d&„Zed'dœd(d)„ƒZd	d*d+dd,d-d.œd/d0„Zddœd1d2„Zd3d4d5œd6d7„Zd8d9„ Zd:d;œd<d=„Zd>d?„ Zd@dA„ Z�ddCdD„ZdEdF„ ZdGdHdIdJœdKdL„ZdMdHdId dNœdOdP„ZdHdIdQdRœdSdT„ZdHdId dRœdUdV„ZdWdHdId ddQdXœdYdZ„Zd dId dQd[œd\d]„ZdWdHdId dNœd^d_„Zd`da„ Zdbdc„ Z ddœddde„Z!dfdgœdhdi„Z"dfdfd djœdkdl„Z#�ddndod dpœdqdr„Z$�dd4dod dpœdsdt„Z%dGdHdId dNœdudv„Z&dwdwd dHd dxœdydz„Z'dwdd d{œd|d}„Z(d~dœdd€„Z)d ddd�œd‚dƒ„Z*d„d d…œd†d‡„Z+dˆd‰d…œdŠd‹„Z,dddŒœd�dŽ„Z-d�ddwdIdwdddd�d‘œ	d’d“„Z.ddwdIdwdddd”œd•d–„Z/ddwdwdddd—œd˜d™„Z0dddšd�d›œdœd�„Z1dddšddddžœdŸd „Z2d3d3d¡œd¢d£„Z3eddœd¤d¥„ƒZ4d3d¦œd§d¨„Z5d3d©œdªd«„Z6d¬dwdwddd­œd®d¯„Z7d¬dwdwdd°œd±d²„Z8ddd d³œd´dµ„Z9ddddd d¶œd·d¸„Z:�dddddddddºœd»d¼„Z;d½d¾d¾dd¿dÀœdÁdÂ„Z<�ddBdÃœddÄdÅœdÆdÇ„Z=dddÅœdÈdÉ„Z>dÊdË„ Z?d dœdÌdÍ„Z@ddÎdˆdÏœdÐdÑ„ZAdÒddÓdÓdÔd¾dÕœdÖd×„ZB�ddØdØdØdÙdÚd�dÛdÜœdÝdÞ„ZC�ddd dßœdàdá„ZD�dd�dÛdâœdãdä„ZEd�ddÛdåœdædç„ZFd�ddèœdédê„ZGdddëdìœdídî„ZH�ddÄddïœdðdñ„ZIdddïœdòdó„ZJd3d½ddôœdõdö„ZKd÷dø„ ZLdùdú„ ZM�dddûœd dddddüœdýdþ„ZNd dddÿœ�d �d„ZOddddddüœ�d�d„ZPd3d3d3d3�dœ�d�d„ZQd3dd �dœ�d�d	„ZRd d �d
œ�d�d„ZSeT�dœ�dd�dœ�d�d„ZUeV�d�d„ ƒZWdBS (   r6   zdict[str, Any] | Noner   ©Ú
parametersrA   c                 C  s&  |d u r
nèt |tƒs.tt| ƒj› d|›�ƒ‚nÄ| d¡d urò|d }| jsl|dv rltd t| ƒj|d ¡ƒ‚t | tj	j
ƒs¢| d¡dv r¢td t| ƒj|d ¡ƒ‚| jsÊ|dkrÊtd t| ƒj|d ¡ƒ‚| jsò|dkròtd t| ƒj|d ¡ƒ‚t |tƒ�stt| ƒj› d|›�ƒ‚|| _|| _d S )	Nz* 'parameters' must be a dict or None, not Ú	__array__©ÚstringÚ
bytestringz8{} is not allowed to have parameters["__array__"] = "{}")ÚcharÚbyteZcategoricalZ
sorted_mapz" 'backend' must be a Backend, not )Ú
isinstanceÚdictÚ	TypeErrorÚtyperI   ÚgetZis_listÚformatÚakÚcontentsr1   Ú
is_indexedÚ	is_recordr   Ú_parametersÚ_backend)rF   r_   rA   Z
array_namerE   rE   rG   Ú_init{   sT    
ÿÿÿÿþÿÿÿÿÿÿÿzContent._init)rC   c                 C  s   | j S rD   )rq   ©rF   rE   rE   rG   rA   ¸   s    zContent.backendr+   c                 C  s
   |   d ¡S rD   )Úform_with_keyrs   rE   rE   rG   Úform¼   s    zContent.formúnode{id}r   zstr | None | Callabler7   )Úform_keyÚid_startrC   c                   sf   |g‰ˆ d u rdd„ }nDt ˆ tƒr2‡ ‡fdd„}n*tˆ ƒrJ‡ ‡fdd„}ntdtˆ ƒ› �ƒ‚|  |¡S )Nc                 S  s   d S rD   rE   )r;   rE   rE   rG   ÚgetkeyÇ   s    z%Content.form_with_key.<locals>.getkeyc                   s$   ˆ j ˆd d�}ˆd  d7  < |S )Nr   )Úidé   )rk   ©r;   Úout©rw   Zhold_idrE   rG   ry   Ì   s    c                   s$   ˆ ˆd | d�}ˆd  d7  < |S )Nr   )rz   r;   r{   rE   r|   r~   rE   rG   ry   Ó   s    z4form_key must be None, a string, or a callable, not )rf   rS   Úcallablerh   ri   Ú_form_with_key)rF   rw   rx   ry   rE   r~   rG   rt   À   s    

ÿzContent.form_with_keyzCallable[[Content], str | None])ry   rC   c                 C  s   t ‚d S rD   ©ÚNotImplementedError)rF   ry   rE   rE   rG   r€   ß   s    zContent._form_with_keyz
type[Form]c                 C  s   t ‚d S rD   r�   rs   rE   rE   rG   Úform_clså   s    zContent.form_clsFrL   r&   )Úforget_lengthrC   c                 C  s
   |   |¡S rD   )Ú_to_typetracer©rF   r„   rE   rE   rG   Úto_typetraceré   s    zContent.to_typetracerc                 C  s   t ‚d S rD   r�   r†   rE   rE   rG   r…   ì   s    zContent._to_typetracer)Ú	recursivec                 C  s   t ‚d S rD   r�   ©rF   rˆ   rE   rE   rG   Ú_touch_dataï   s    zContent._touch_datac                 C  s   t ‚d S rD   r�   r‰   rE   rE   rG   Ú_touch_shapeò   s    zContent._touch_shaper   c                 C  s   t ‚d S rD   r�   rs   rE   rE   rG   Úlengthõ   s    zContent.lengthz#Callable[[Content, Form, str], str]zMutableMapping[str, Any] | NonezLiteral['<', '>']z#tuple[Form, int, Mapping[str, Any]])ru   ry   Ú	containerrA   Ú	byteorderrC   c                 C  s   t ‚d S rD   r�   )rF   ru   ry   r�   rA   rŽ   rE   rE   rG   Ú_to_buffersù   s    zContent._to_buffersc                 C  s
   t | jƒS rD   )r7   rŒ   rs   rE   rE   rG   Ú__len__  s    zContent.__len__rS   z	list[str])ÚindentrC   c              
   C  sD   g }| j d ur@| j  ¡ D ]&\}}| d|› d|›d|›d�¡ q|S )NÚ
z<parameter name=ú>z</parameter>)rp   ÚitemsÚappend)rF   r‘   r}   ÚkÚvrE   rE   rG   Ú_repr_extra  s
    
 zContent._repr_extrac                 C  s   d S rD   rE   rs   rE   rE   rG   Úmaybe_to_NumpyArray  s    zContent.maybe_to_NumpyArrayzKernelError | None)Úerrorc                 C  s6   |d u s|j d u rd S | j |¡}tj | ||¡‚d S rD   )rS   rq   Zformat_kernel_errorrl   Ú_errorsÚindex_error)rF   rš   ÚslicerÚmessagerE   rE   rG   Ú_maybe_index_error  s    zContent._maybe_index_errorc                 O  s   t dƒ‚d S ©Nzfdo not apply NumPy functions to low-level layouts (Content subclasses); put them in ak.highlevel.Array©rh   )rF   ZufuncÚmethodÚinputsÚkwargsrE   rE   rG   Ú__array_ufunc__  s    ÿzContent.__array_ufunc__c                 C  s   t dƒ‚d S r    r¡   )rF   ÚfuncÚtypesÚargsr¤   rE   rE   rG   Ú__array_function__  s    ÿzContent.__array_function__Nc                 C  s   t dƒ‚d S )Nzndo not try to convert low-level layouts (Content subclasses) into NumPy arrays; put them in ak.highlevel.Arrayr¡   )rF   ÚdtyperE   rE   rG   r`   !  s    ÿzContent.__array__c                 c  s4   | j jjstdƒ‚tt| ƒƒD ]}|  |¡V  qd S )Nz0cannot iterate on an array without concrete data)rq   ÚnplikeÚ
known_datarh   ÚrangeÚlenÚ_getitem_at)rF   ÚirE   rE   rG   Ú__iter__&  s    
zContent.__iter__zSliceItem | tupleztuple[SliceItem, ...]zIndex | None)ÚheadÚtailÚadvancedc                 C  s$   t j |¡\}}|  |¡ |||¡S rD   )rl   Ú_slicingÚ	head_tailÚ_getitem_fieldÚ_getitem_next)rF   r²   r³   r´   ÚnextheadÚnexttailrE   rE   rG   Ú_getitem_next_field-  s    zContent._getitem_next_fieldr/   )r²   r³   r´   rC   c           	      C  sf   g g  }}|D ](}t |ttfƒr,| |¡ q| |¡ qtj t|ƒ¡\}}|  |t|ƒ¡ 	|||¡S rD   )
rf   rS   Úlistr•   rl   rµ   r¶   ÚtupleÚ_getitem_fieldsr¸   )	rF   r²   r³   r´   Úonly_fieldsZ
not_fieldsÚxr¹   rº   rE   rE   rG   Ú_getitem_next_fields6  s    
ÿzContent._getitem_next_fieldsr2   )r³   r´   rC   c                 C  s.   t j |¡\}}t jj|  |||¡ddd d�S )Nr{   r   ©r_   )rl   rµ   r¶   rm   r2   r¸   )rF   r³   r´   r¹   rº   rE   rE   rG   Ú_getitem_next_newaxisD  s    ÿzContent._getitem_next_newaxisc                 C  sª   | j \}}tdd„ |D ƒƒ}t|ƒdksH|d |d   krD|krfn ntj |¡\}}|  |||¡S ||d |d hv rŒtj | t	d¡‚n|  t
d ƒt	g|¢R |¡S d S )Nc                 s  s,   | ]$}t |ƒst|ttfƒr d ndV  qdS )r{   r   N)r   rf   Úslicer-   ©Ú.0rÀ   rE   rE   rG   Ú	<genexpr>Q  s   ÿz1Content._getitem_next_ellipsis.<locals>.<genexpr>r   r{   zKellipsis (`...`) can't be used on data with different numbers of dimensions)Zminmax_depthÚsumr®   rl   rµ   r¶   r¸   r›   rœ   ÚEllipsisrÄ   )rF   r³   r´   ZmindepthZmaxdepthZ	dimlengthr¹   rº   rE   rE   rG   Ú_getitem_next_ellipsisL  s    
þ,ýzContent._getitem_next_ellipsisr0   )r²   r³   r´   ÚrawrŒ   rC   c           
      C  sÌ   |t ur|dkrdn|}|j}|j}| | jj¡}t |j| | jj¡}|j| jju rd|j| jju shJ ‚| j	| jd|j
j|j
jf |j|j|j||jƒ|d� tjjj||j| jd�}	tjj|	|d| jd�S )Nr   r{   Zawkward_missing_repeat©r�   rÂ   )r   ÚindexrŒ   r   rq   Úindex_npliker-   Úemptyr«   rŸ   rª   ri   ÚdataÚ_sizerl   rm   r0   Ú
simplifiedÚcontentrp   r2   )
rF   r²   r³   r´   rË   rŒ   rÍ   ZindexlengthZoutindexr}   rE   rE   rG   Ú_getitem_next_regular_missingd  s<    	þÿþÿù	ö
ÿ
ÿz%Content._getitem_next_regular_missing)r²   r´   ÚthatrC   c              
   C  s|  |  | j¡}|j ¡ }|j}| d¡}| jjjrh|j|jk rht	j
 | |d|j› dt|ƒj› d|j› �¡‚t |j| jj¡}t |j| jj¡}	t |j| jj¡}
|j| jju ræ|jj| jju ræ|j| jju ræ|	j| jju ræ|
j| jju sêJ ‚| j| jd|jj|jjj|jj|	jj|
jjf |j|jj|j|	j|
j|jƒ|d� | |	|
|j|¡}t	jjj||| jd�}t	jj||jd| jd�S )	Nr   z+cannot fit masked jagged slice with length z into z	 of size Z<awkward_Content_getitem_next_missing_jagged_getmaskstartstoprÌ   rÂ   r{   )Ú
to_backendrq   rÓ   Zto_ListOffsetArray64Ú_indexr¯   r«   r¬   rŒ   rl   r›   rœ   ri   rI   r-   rÏ   rÎ   Ú_offsetsrŸ   rª   rÐ   Ú_getitem_next_jaggedrm   r0   rÒ   rp   r2   )rF   r²   r³   r´   rÕ   ZjaggedrÍ   rÓ   Z
outputmaskÚstartsÚstopsÚtmpr}   rE   rE   rG   Ú_getitem_next_missing_jaggedŽ  sb    

ýÿþýüûûÿóðÿÿz$Content._getitem_next_missing_jaggedc              
   C  s\  t |tjjƒsJ ‚|d ur*tj | |d¡‚t |jtjjƒrf| jj	j
rV| jdkrVtdƒ‚|  |||| ¡S t |jtjjƒr’t|jjƒ}|  |||¡}n|  |j||¡}t |tjjƒrÄ|  |||||j¡S t |tjjƒ�rJt|jƒdkræ|S g }|jD ]>}t |tjjƒ�r | |  |||||j¡¡ qðtd|› �ƒ‚qðtjj||j| j| jd�S td|› �ƒ‚d S )NzEcannot mix missing values in slice with NumPy-style advanced indexingr{   z'reached a not-well-considered code pathr   zBFIXME: unhandled case of SliceMissing with RecordArray containing r^   z+FIXME: unhandled case of SliceMissing with )rf   rl   rm   r0   r›   rœ   rÓ   ZListOffsetArrayrq   r«   r¬   rŒ   r‚   rÝ   r1   r-   rÐ   r¸   r2   rÔ   ÚRecordArrayr®   Ú_fieldsr•   rp   )rF   r²   r³   r´   ZheadcontentZnextcontentrm   rÓ   rE   rE   rG   Ú_getitem_next_missingÂ  sT    ýÿ
ÿÿÿüÿzContent._getitem_next_missingc                 C  s
   |   |¡S rD   )Ú_getitem©rF   ÚwhererE   rE   rG   Ú__getitem__ÿ  s    zContent.__getitem__c                 C  sÌ  t |ƒr|  tj |¡¡S t|tƒr`|jd u r`| jj	 
t|| jj	d�| j¡\}}}}|  ||¡S t|tƒrv|  |f¡S t|tƒrŠ|  |¡S |tju r |  |f¡S |tu r´|  |f¡S t|tƒ�rjt|ƒdkrÐ| S t| g|¢R ddiŽ}|  |¡}tj ||¡}tj ||¡}tjj||jdd d�}	|	 |d |dd … d ¡}
|
jtu�r\|
jdk�r\|
 ¡ S |
 d¡S �n^t|tjj ƒ�r†|  |j!¡S t|tjj"ƒ�rÈ|j#| ju�rÈt| |dd�}|  |¡ | |¡¡S t|tjj$ƒ�r2t%|j&| jj	| jj'd�}t (|j)tj*¡�r$d}t+| jj	 ,|d	¡| jj	d�}nÈt (|j)tj-¡�rjd
}t+| jj	 ,| jj	j.|tj*dd�d	¡| jj	d�}n‚t (|j)tj/¡�rÐt|j&j0ƒdk�r¶| jj	 1|¡d }t+|| jj	d�}d
}n| jj	 1|¡}|  |¡S nt2d 3t4|j&ƒ 5dd¡¡ƒ‚tj 6|  7||¡|j0¡}
|
jtu�r$|
jdk�r$|
 ¡ S |
 d¡S �n–t|tjjƒ�rn| 8¡ }|d u �r`|  |f¡S |  |¡S �nZt|t"ƒ�rª|j9d u�rª|j9 :d¡dv �rª|  ;tj< =|¡¡S t|tjj>ƒ�rÆ| ?tj*¡S t|t"ƒ�rÞ|  |f¡S t@|ƒ�r°tA|d d�}|d u�r2| B|¡�r2tj<jCjD|dddddddd�}|  |¡S t|ƒdk�rZ| j7t+ Ed| jj	¡dd�S tFdd„ |D ƒƒ�r||  ;tG|ƒ¡S t tj<jCjD|dddddddd�| j¡}|  |¡S nt2dt4|ƒ 5dd¡ ƒ‚d S )N©r«   r   Úcoerce_to_commonTr{   rÂ   )ræ   )Zfrom_nplike)éÿÿÿÿÚcopied)rª   ÚcopyzAarray slice must be an array of integers or booleans, not

    {}r’   z
    r`   ra   )ÚdefaultFrš   zas-characters)Zallow_recordZallow_unknownZnone_policyZregulararrayZuse_from_iterZprimitive_policyZstring_policy)Ú
allow_lazyc                 s  s   | ]}t |tƒV  qd S rD   )rf   rS   rÅ   rE   rE   rG   rÇ   œ  ó    z#Content._getitem.<locals>.<genexpr>zùonly integers, slices (`:`), ellipsis (`...`), np.newaxis (`None`), integer/boolean arrays (possibly with variable-length nested lists or missing values), field name (str) or names (non-tuple iterable of str) are valid indices for slicing, not

    )Hr   r¯   rl   rµ   Znormalize_integer_likerf   rÄ   Ústeprq   rÎ   Zderive_slice_for_lengthr   rŒ   Ú_getitem_rangerá   rS   r·   ÚnpZnewaxisrÉ   r½   r®   r   rÖ   Znormalise_itemsZprepare_advanced_indexingrm   r2   r¸   r   Z_getitem_nothingÚ	highlevelÚArrayr;   r6   rA   r1   r   rÐ   r«   Z
issubdtyperª   Úint64r-   ZreshapeÚintegerZastypeZbool_ÚshapeZnonzerorh   rk   ÚreprÚreplaceZgetitem_next_array_wrapÚ_carryr™   rp   rj   r¾   Ú
operationsÚto_listZ
EmptyArrayZto_NumpyArrayr   r   Zis_own_arrayZak_to_layoutÚ_implrÏ   Úallr¼   )rF   rã   ÚstartÚstopÚ_rA   Úthisr”   Z	nextwhereÚnextr}   Zdata_as_indexrë   ÚcarryZwheresZmaybe_numpyr«   r;   rE   rE   rG   rá     s   ÿ




üÿ
þýþÿüù	ÿÿÿ
ÿþý
ø

þø
õüÿzContent._getitemc                 C  s   t ‚d S rD   r�   rs   rE   rE   rG   Ú_is_getitem_at_placeholder¸  s    z"Content._is_getitem_at_placeholderr   )rã   c                 C  s   t ‚d S rD   r�   râ   rE   rE   rG   r¯   »  s    zContent._getitem_at)rü   rý   rC   c                 C  s   t ‚d S rD   r�   )rF   rü   rý   rE   rE   rG   rî   ¾  s    zContent._getitem_rangerE   zstr | SupportsIndexztuple[str, ...])rã   r¿   rC   c                 C  s   t ‚d S rD   r�   ©rF   rã   r¿   rE   rE   rG   r·   Á  s    zContent._getitem_fieldc                 C  s   t ‚d S rD   r�   r  rE   rE   rG   r¾   Æ  s    zContent._getitem_fieldsc                 C  s   t ‚d S rD   r�   )rF   r²   r³   r´   rE   rE   rG   r¸   Ë  s    zContent._getitem_nextr,   )ÚslicestartsÚ
slicestopsÚslicecontentr³   rC   c                 C  s   t ‚d S rD   r�   )rF   r  r  r  r³   rE   rE   rG   rÙ   Ó  s    zContent._getitem_next_jagged)r  rë   rC   c                 C  s   t ‚d S rD   r�   )rF   r  rë   rE   rE   rG   r÷   Ü  s    zContent._carryr1   c                 C  sJ   t  | j| jj¡}| j | jdtjf |j|jƒ¡ t	j
j|jd | jd�S )NZawkward_localindexr^   )r-   rÏ   rŒ   rq   rÎ   Úmaybe_kernel_errorrï   rò   rÐ   rl   rm   r1   )rF   Z
localindexrE   rE   rG   Ú_local_index_axis0ß  s    þÿ
ÿzContent._local_index_axis0)ÚotherÚ	mergeboolrC   c                 C  s   t ‚d S rD   r�   )rF   r	  r
  rE   rE   rG   Ú_mergeable_nextë  s    zContent._mergeable_nextzSequence[Content])ÚothersrC   c                 C  s   t ‚d S rD   r�   )rF   r  rE   rE   rG   Ú
_mergemanyî  s    zContent._mergemanyzlist[Content]z#tuple[list[Content], list[Content]]c                 C  sž   t |ƒdkrtdƒ‚| g}g }t|ƒ}|D ]:}|js@|js@|jrZ| |¡ | |¡  qfq*| |¡ q*tdd„ || D ƒƒr–t	dd„ || D ƒƒs–J ‚||fS )Nr   zFto merge this array with 'others', at least one other must be providedc                 s  s   | ]}|j jjV  qd S rD   )rA   r«   r¬   rÅ   rE   rE   rG   rÇ     rì   z,Content._merging_strategy.<locals>.<genexpr>)
r®   Ú
ValueErrorÚiterrn   Ú	is_optionZis_unionr•   ÚextendÚanyrû   )rF   r  r²   r³   Z	it_othersr	  rE   rE   rG   Ú_merging_strategyñ  s"    ÿ

ÿzContent._merging_strategy)Úaxisr<   c                 C  s   t ‚d S rD   r�   ©rF   r  r<   rE   rE   rG   Ú_local_index  s    zContent._local_indexzak._reducers.Reducerzdict | None)	ÚreducerÚnegaxisrÚ   ÚshiftsÚparentsÚ	outlengthÚmaskrT   r@   c
           
      C  s   t ‚d S rD   r�   )
rF   r  r  rÚ   r  r  r  r  rT   r@   rE   rE   rG   Ú_reduce_next  s    zContent._reduce_next)r  rÚ   r  r  r  Ú	ascendingÚstablec                 C  s   t ‚d S rD   r�   )rF   r  rÚ   r  r  r  r  r  rE   rE   rG   Ú_argsort_next  s    
zContent._argsort_next)r  rÚ   r  r  r  r  c                 C  s   t ‚d S rD   r�   )rF   r  rÚ   r  r  r  r  rE   rE   rG   Ú
_sort_next)  s    	zContent._sort_nextzlist[str] | None)ÚnÚreplacementÚrecordlookupr_   c              
   C  sê  | j }|r||d  }|}|d u s*|d u r0|}n`||kr>d}nR||krLd}nD|d |kr`|| }|}td|d ƒD ]}||| d  }|| }qr| jjj|tjd�}	g }
t|ƒD ]8}tj|| jjtjd�}|
 	|¡ | jj
jr°|j|	|< q°tj|| jjtjd�}tj|| jjtjd�}|j
| jju �r6|j
| jju �s:J ‚| j | jdtj|jjj|jjjf |	|j|j||| j dƒ¡ g }tjj}|
D ]*}| 	tjjj|| d d�¡ |d j }�qˆ|tjju �rÒ| jj
j�rÒJ ‚tjj||||| jd	�S )
Nr{   r   é   ©rª   )r«   rª   Z$awkward_RegularArray_combinations_64rÂ   rç   r^   )rŒ   r­   rq   rÎ   rÏ   rï   Zintpr-   rò   r•   r«   r¬   Úptrr  rÐ   rª   ri   rl   Z_utilr*   rm   ZIndexedArrayrÒ   rÞ   )rF   r"  r#  r$  r_   ÚsizeZthisnZcombinationslenÚjZ
tocarryrawZtocarryr°   r'  ZtoindexZ	fromindexrm   rŒ   rE   rE   rG   Ú_combinations_axis04  sz    
ý

ÿþýÿôÿÿÿzContent._combinations_axis0)r"  r#  r$  r_   r  r<   c                 C  s   t ‚d S rD   r�   )rF   r"  r#  r$  r_   r  r<   rE   rE   rG   Ú_combinations}  s    	zContent._combinations)ÚpathrC   c                 C  s   t ‚d S rD   r�   )rF   r,  rE   rE   rG   Ú_validity_errorˆ  s    zContent._validity_errorc                 C  s   |   ¡ S rD   )Z_nbytes_partrs   rE   rE   rG   Únbytes‹  s    zContent.nbytes)Úkeyc                 C  s   | j  | |¡S )a  
        Return the value of the outermost parameter matching `key` in a sequence
        of nested lists, stopping at the first record or tuple layer.

        If a layer has #ak.types.UnionType, the value is only returned if all
        possibilities have the same value.
        )rƒ   Úpurelist_parameter)rF   r/  rE   rE   rG   r0  �  s    zContent.purelist_parameter)Úkeysc                 G  s   | j j| g|¢R Ž S )a"  
        Return the value of the outermost parameter matching one of `keys` in a sequence
        of nested lists, stopping at the first record or tuple layer.

        If a layer has #ak.types.UnionType, the value is only returned if all
        possibilities have the same value.
        )rƒ   Úpurelist_parameters)rF   r1  rE   rE   rG   r2  ™  s    zContent.purelist_parametersr"   )r  rÚ   r  r  rC   c                 C  s   t ‚d S rD   r�   ©rF   r  rÚ   r  r  rE   rE   rG   Ú
_is_unique£  s    zContent._is_unique)r  rÚ   r  r  c                 C  s   t ‚d S rD   r�   r3  rE   rE   rG   Ú_unique¬  s    zContent._unique)ÚtargetÚcliprC   c                 C  s”   |s<| j tu s|| j k r<t| jjj| j tjd�| jjd�}nHt || jj¡}|j	| jju s^J ‚| j 
| jd|jjf |j|| j ƒ¡ tjj || ¡S )Nr&  rå   Z!awkward_index_rpad_and_clip_axis0)rŒ   r   r-   rq   rÎ   Zarangerï   rò   rÏ   r«   r  rª   ri   rÐ   rl   rm   r0   rÒ   )rF   r6  r7  rÍ   rE   rE   rG   Ú_pad_none_axis0µ  s"    þÿÿ
ýÿzContent._pad_none_axis0)r6  r  r<   r7  rC   c                 C  s   t ‚d S rD   r�   )rF   r6  r  r<   r7  rE   rE   rG   Ú	_pad_noneÉ  s    zContent._pad_noneT)rV   rW   rX   rZ   r[   r\   r]   c	                 C  s<   dd l }	|	jj d¡}
|  |
d d | j||||||||dœ¡S )Nr   Úto_arrow)rV   rW   rX   rY   rZ   r[   r\   r]   )Zawkward._connect.pyarrowÚ_connectÚpyarrowZimport_pyarrowÚ	_to_arrowrŒ   )rF   rV   rW   rX   rY   rZ   r[   r\   r]   Úawkwardr<  rE   rE   rG   r:  Ì  s"    øûzContent.to_arrowr!   r:   rU   )r<  Ú	mask_nodeÚ
validbytesrŒ   rB   c                 C  s   t ‚d S rD   r�   )rF   r<  r?  r@  rŒ   rB   rE   rE   rG   r=  ë  s    zContent._to_arrow©rA   zBackend | str | None)Úallow_missingrA   c                C  s$   |d u r| j }nt|ƒ}|  ||¡S rD   )rq   r   Ú_to_backend_array©rF   rB  rA   rE   rE   rG   Úto_backend_arrayõ  s    zContent.to_backend_arrayc                 C  s   t ‚d S rD   r�   rD  rE   rE   rG   rC  þ  s    zContent._to_backend_arrayc                 C  s   |   ¡ S rD   )Ú
_drop_noners   rE   rE   rG   Ú	drop_none  s    zContent.drop_nonec                 C  s   t ‚d S rD   r�   rs   rE   rE   rG   rF    s    zContent._drop_nonerR   )rA   rB   rC   c                 C  s   t ‚d S rD   r�   )rF   rA   rB   rE   rE   rG   Ú_remove_structure  s    zContent._remove_structurer5   r8   r9   )Úactionr<   r=   r>   rB   rC   c                 C  s   t ‚d S rD   r�   )rF   rI  r<   r=   r>   rB   rE   rE   rG   Ú_recursively_apply  s    zContent._recursively_applyrN   ztuple[str, str] | Nonezbool | Noner¼   )Ú
nan_stringÚposinf_stringÚneginf_stringÚcomplex_record_fieldsÚconvert_bytesr@   rC   c           	   
   C  s~   |d u rd }d }nNt |tƒrXt |tƒrXt|ƒdkrXt |d tƒrXt |d tƒrX|\}}nd\}}|  ¡  |||||||dœ¡S )Nr%  r   r{   )NN)rK  rL  rM  Úcomplex_real_stringÚcomplex_imag_stringrO  )rf   r   r   r®   rS   Ú	to_packedÚ_to_list)	rF   rK  rL  rM  rN  rO  r@   rP  rQ  rE   rE   rG   Úto_json  s2    	ÿþ
ýüû
úþzContent.to_json)rˆ   rC   c                 C  s   t ‚d S rD   r�   r‰   rE   rE   rG   rR  9  s    zContent.to_packed)r@   rC   c                 C  s   |   ¡  |d ¡S rD   )rR  rS  )rF   r@   rE   rE   rG   rù   <  s    zContent.to_list)r@   Újson_conversionsrC   c                 C  s   t ‚d S rD   r�   )rF   r@   rU  rE   rE   rG   rS  ?  s    zContent._to_list)r@   rU  c                   sÐ  | j r0t| |ƒj}|tjjjuo,t|ddƒ }n(t| |ƒj}|tjjjuoVt|ddƒ }|�rÌt	| |d�}d g| j
 }t| j
ƒD ]`}|| ||< t|| tjjtjjfƒrÂ|| j ||¡||< q€t|| dƒr€||  ¡ ||< q€|d u�rÈ|d }|d u�r*t|ƒD ]"\}}	t|	tƒ�r||	ƒ||< �qd }
|d }|d }|d u�r°tdd	„ |D ƒƒ�r°d gt|ƒ }
t|ƒD ]<\}}	t|	tƒ�rœ|	j||< |	j|
|< n|	||< d |
|< �qrg }|d
 ‰ˆd u�ràtj‰| ‡‡fdd„¡ |d ‰ˆd u�rtdƒ‰ | ‡ ‡fdd„¡ |d ‰ˆd u�r<tdƒ‰| ‡‡fdd„¡ t|ƒdk�rž|d }t|ƒD ]\}}	||	ƒ||< �qZ|
d u�r�t|
ƒD ]\}}	||	ƒ|
|< �q„nòt|ƒdk�r|d }|d }t|ƒD ]\}}	|||	ƒƒ||< �qÄ|
d u�r�t|
ƒD ]\}}	|||	ƒƒ|
|< �qòn€t|ƒdk�r�|d }|d }|d }t|ƒD ]\}}	||||	ƒƒƒ||< �q>|
d u�r�t|
ƒD ]\}}	||||	ƒƒƒ|
|< �qp|
d u�rÈtt||
ƒƒD ]\}\}}||||i||< �q¨|S d S )NZignore_in_to_listF)r@   ÚtolistrO  rP  rQ  c                 s  s$   | ]}t |tƒ ot |tƒV  qd S rD   )rf   r
   r	   rÅ   rE   rE   rG   rÇ   l  s   z*Content._to_list_custom.<locals>.<genexpr>rK  c                   s   ˆ | ƒrˆS | S rD   rE   ©rÀ   )ÚisnanrK  rE   rG   Ú<lambda>}  rì   z)Content._to_list_custom.<locals>.<lambda>rL  Úinfc                   s   | ˆ krˆS | S rD   rE   rW  )rZ  rL  rE   rG   rY  ‚  rì   rM  z-infc                   s   | ˆ krˆS | S rD   rE   rW  )ÚminfrM  rE   rG   rY  ‡  rì   r{   r   r%  é   )ro   r   rä   rl   rð   ZRecordÚgetattrr   rñ   r   rŒ   r­   rf   Z_layoutrS  ÚhasattrrV  Ú	enumerateÚbytesr  r®   r	   ÚrealÚimagÚmathrX  r•   ÚfloatÚzip)rF   r@   rU  ÚgetitemZ
overloadedÚarrayr}   r°   rO  rÀ   ZoutimagrP  rQ  ÚfiltersZf0Úf1Úf2ra  rb  rE   )rZ  rX  r[  rK  rM  rL  rG   Ú_to_list_customD  sž    ÿÿ


ÿ








zContent._to_list_customztuple[Index, Content])r  r<   rC   c                 C  s   t ‚d S rD   r�   r  rE   rE   rG   Ú_offsets_and_flattened¨  s    zContent._offsets_and_flattened)rA   rC   c                 C  s4   |d u r| j }nt|ƒ}|| j u r&| S |  |¡S d S rD   )rq   r   Ú_to_backend©rF   rA   rE   rE   rG   rÖ   «  s    
zContent.to_backendc                 C  s   t ‚d S rD   r�   rn  rE   rE   rG   rm  µ  s    zContent._to_backend)r/  ÚvaluerC   c                 C  s8   t   | ¡}| jd u ri }nt   | j¡}|||< ||_|S rD   )ré   rp   )rF   r/  ro  r}   r_   rE   rE   rG   Úwith_parameter¸  s    

zContent.with_parameterc                 C  s   t ‚d S rD   r�   rs   rE   rE   rG   Ú__copy__Ä  s    zContent.__copy__c                 C  s   t ‚d S rD   r�   )rF   ÚmemorE   rE   rG   Ú__deepcopy__Ç  s    zContent.__deepcopy__)Úall_parameters)r	  Úindex_dtypeÚ
numpyarrayrt  rC   c                C  s   |   ||||¡S rD   )Ú_is_equal_to©rF   r	  ru  rv  rt  rE   rE   rG   Úis_equal_toÊ  s    zContent.is_equal_to)r	  rt  rC   c                 C  sF   |rt nt}| j|ju oD| jtu s8|jtu s8| j|jkoD|| j|jƒS rD   )r   r   Ú	__class__rŒ   r   rp   )rF   r	  rt  Zcompare_parametersrE   rE   rG   Ú_is_equal_to_genericÔ  s    
ÿ
ÿ
üùzContent._is_equal_to_genericc                 C  s   t ‚d S rD   r�   rx  rE   rE   rG   rw  â  s    zContent._is_equal_to)r‘   ÚpreÚpostrC   c                 C  s   t ‚d S rD   r�   )rF   r‘   r|  r}  rE   rE   rG   Ú_reprç  s    zContent._repr)ÚnameÚincluding_unknownrC   c                 C  s   t ‚d S rD   r�   )rF   r  r€  rE   rE   rG   Ú_numbers_to_typeê  s    zContent._numbers_to_type)ro  rC   c                 C  s   t ‚d S rD   r�   )rF   ro  rE   rE   rG   Ú
_fill_noneí  s    zContent._fill_nonerÂ   zJSONMapping | None)r_   rC   c                C  s   t ‚d S rD   r�   )rF   r_   rE   rE   rG   ré   ð  s    zContent.copyc                 C  s   | j S rD   )r  )ÚclsrE   rE   rG   Ú_arrow_needs_option_typeó  s    z Content._arrow_needs_option_type)rv   r   )F)N)rE   )rE   )FFFNFTTF)T)NNNNNN)T)N)N)TT)XrI   rJ   rK   rr   ÚpropertyrA   ru   rt   r€   rƒ   r‡   r…   rŠ   r‹   rŒ   r�   r�   r˜   r™   rŸ   r¥   r©   r`   r±   r»   rÁ   rÃ   rÊ   rÔ   rÝ   rà   rä   rá   r  r¯   rî   r·   r¾   r¸   rÙ   r÷   r  r  r  r  r  r  r   r!  r*  r+  r-  r.  r0  r2  r4  r5  r8  r9  r:  r=  rE  rC  rG  rF  rH  rJ  rT  rR  rù   rS  rk  rl  rÖ   rm  rp  rq  rs  ry  r{  rw  r~  r�  r‚  r*   ré   Úclassmethodr„  rE   rE   rE   rG   r6   z   sâ   =ÿ
	*4= 7ÿÿ	I

		       ÷ÿÿ	     ù#d
 üú
 r6   ri   ©Úobjc                 C  s    t | tƒrddœdd„}|S d S )Nr6   r‡  c                 S  s   | j S rD   rA  r‡  rE   rE   rG   Úfinderü  s    z$find_content_backend.<locals>.finder)Ú
issubclassr6   )rˆ  r‰  rE   rE   rG   Úfind_content_backendø  s    
r‹  )YÚ
__future__r   ré   rc  Úcollections.abcr   r   r   r   r   r   Únumbersr	   r
   r>  rl   Zawkward._backends.backendr   Zawkward._backends.dispatchr   r   r   Zawkward._behaviorr   r   Zawkward._kernelsr   Zawkward._layoutr   Zawkward._meta.metar   Zawkward._nplikesr   Zawkward._nplikes.dispatchr   Zawkward._nplikes.numpyr   Zawkward._nplikes.numpy_liker   r   Zawkward._nplikes.shaper   r   Zawkward._parametersr   r   Zawkward._regularizer   r   Zawkward._slicingr   Zawkward._typingr    r!   r"   r#   r$   r%   r&   r'   r(   r)   Zawkward._utilr*   Zawkward.forms.formr+   Zawkward.indexr,   r-   r.   r/   Z#awkward.contents.indexedoptionarrayr0   Zawkward.contents.numpyarrayr1   Zawkward.contents.regulararrayr2   Úinstancerï   Únumpyr3   rQ   r4   r5   r9   rR   rU   r6   r‹  rE   rE   rE   rG   Ú<module>   sb    0
	         