a
    yn„f˜-  ã                	   @  sš  d dl mZ d dlmZmZ d dlmZ d dl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mZmZmZmZ d dlmZ er¸d dlmZ e  ¡ Z!e  ¡ Z"e  ¡ Z#edƒZ$erôd dl%m&Z& d dl%m'Z( G dd„ deƒZ)edƒZ*edƒZ+d;ddddœdd„Z,G dd„ dƒZ-ddœd d!d"d#œd$d%„Z.d<dd(d)d d)d(d*d+œd,d-„Z/d.d/„ Z0d=d1d2œd3d4„Z1d5d6d6d7d8œd9d:„Z2dS )>é    )Úannotations)ÚMappingÚSequence)ÚLiteral)ÚBackend)Úcommon_backendÚregularize_backend)ÚNumpyBackend)Úbehavior_of)Únplike_of_obj)ÚNumpy)ÚNumpyMetadata)ÚTYPE_CHECKINGÚAnyÚ
NamedTupleÚSelfÚTypeVar)Ú	AxisError©ÚContentÚT)ÚArray©ÚRecordc                   @  s&   e Zd ZU ded< ded< ded< dS )ÚHighLevelMetadatar   ÚbackendúMapping | NoneÚattrsÚbehaviorN)Ú__name__Ú
__module__Ú__qualname__Ú__annotations__© r#   r#   úR/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/awkward/_layout.pyr   $   s   
r   ÚKÚVNzSequence[Mapping[K, V]]zMapping[K, V] | NonezMapping[K, V])ÚmappingsÚdefaultÚreturnc                 C  s6   t | ƒdkr|S t | ƒdkr$| d S dd„ | D ƒS d S )Nr   é   c                 S  s$   i | ]}|  ¡ D ]\}}||“qqS r#   )Úitems)Ú.0ÚmappingÚkÚvr#   r#   r$   Ú
<dictcomp>7   ó    z"merge_mappings.<locals>.<dictcomp>)Úlen)r'   r(   r#   r#   r$   Úmerge_mappings.   s
    r3   c                   @  sÌ   e Zd Zd,dddœdd„Zdd„ Zd	d
„ Zdd„ Zdd„ Zeddœdd„ƒZ	eddœdd„ƒZ
ddœdd„Zdddœdd„Zdddddddd œd!d"d"d#d#d$d"d"d!d%œ	d&d'„Zddd(œd!d"d"d!d)œd*d+„ZdS )-ÚHighLevelContextNr   zMapping[str, Any] | None©r   r   c                 C  s"   || _ || _d| _g | _g | _d S )NF)Ú	_behaviorÚ_attrsÚ_is_finalizedÚ_attrs_from_objectsÚ_behavior_from_objects©Úselfr   r   r#   r#   r$   Ú__init__;   s
    zHighLevelContext.__init__c                 C  s   | S ©Nr#   ©r<   r#   r#   r$   Ú	__enter__E   s    zHighLevelContext.__enter__c                 C  s   |   ¡  d S r>   )Úfinalize)r<   Úexc_typeÚexc_valÚexc_tbr#   r#   r$   Ú__exit__H   s    zHighLevelContext.__exit__c                 C  s   | j stdƒ‚d S )Nz+HighLevelContext has not yet been finalized©r8   ÚRuntimeErrorr?   r#   r#   r$   Ú_ensure_finalizedK   s    z"HighLevelContext._ensure_finalizedc                 C  s   | j rtdƒ‚d S )Nz+HighLevelContext has already been finalizedrF   r?   r#   r#   r$   Ú_ensure_not_finalizedO   s    z&HighLevelContext._ensure_not_finalized)r)   c                 C  s   |   ¡  | jS r>   )rH   r7   r?   r#   r#   r$   r   S   s    zHighLevelContext.attrsc                 C  s   |   ¡  | jS r>   )rH   r6   r?   r#   r#   r$   r   X   s    zHighLevelContext.behaviorr   c                 C  sr   |   ¡  | jd u r,t| jd d d… d d�}n| j}| jd u rVt| jd d d… d d�}n| j}|| _|| _d| _| S )Néÿÿÿÿ)r(   T)rI   r6   r3   r:   r7   r9   r8   r;   r#   r#   r$   rA   ]   s    

zHighLevelContext.finalizer   )Úobjr)   c                 C  s`   ddl m}m}m} |  ¡  t||||fƒr\|jd urD| j |j¡ |j	d ur\| j
 |j	¡ |S )Nr   )r   ÚArrayBuilderr   )Úawkward.highlevelr   rL   r   rI   Ú
isinstancer7   r9   Úappendr6   r:   )r<   rK   r   rL   r   r#   r#   r$   Úupdateq   s    

zHighLevelContext.updateTFÚerrorÚpromotezas-characters)Úallow_recordÚallow_unknownÚnone_policyÚprimitive_policyÚstring_policyÚuse_from_iterÚregulararrayr   Úboolú+Literal['error', 'promote', 'pass-through']z<Literal['error', 'promote', 'pass-through', 'as-characters'])	rK   rS   rT   rU   rV   rW   rX   rY   r)   c          
   
   C  s.   ddl m}	 |  |¡ |	||||||||d�S )Nr   )Ú_impl)rS   rT   rU   rX   rV   rW   rY   )Zawkward.operations.ak_to_layoutr\   rP   )
r<   rK   rS   rT   rU   rV   rW   rX   rY   Zto_layout_implr#   r#   r$   Úunwrap   s    
øzHighLevelContext.unwrap)Ú	highlevelÚallow_other)rK   r^   r_   r)   c                C  s   |   ¡  t||| j| j|d�S )N)r^   r   r   r_   )rH   Úwrap_layoutr7   r6   )r<   rK   r^   r_   r#   r#   r$   Úwrapœ   s    ûzHighLevelContext.wrap)NN)r   r    r!   r=   r@   rE   rH   rI   Úpropertyr   r   rA   rP   r]   ra   r#   r#   r#   r$   r4   :   s,    ÿ
ô"ÿr4   Úcpu)Údefault_backendr   zstr | Backendz	list[Any])Úlayoutsrd   r)   c                   s>   dd„ |D ƒ}t |ƒdkr$t|ƒ‰ nt| ƒ‰ ‡ fdd„|D ƒS )z#

    Returns:
        object:
    c                 S  s   h | ]}t |d ƒr|j’qS ©r   )Úhasattrr   ©r,   Úlayoutr#   r#   r$   Ú	<setcomp>²   s   z&ensure_same_backend.<locals>.<setcomp>r*   c                   s$   g | ]}t |d ƒr| ˆ ¡n|‘qS )Ú
to_backend)rg   rk   rh   rf   r#   r$   Ú
<listcomp>¼   s   ÿz'ensure_same_backend.<locals>.<listcomp>)r2   r   r   )rd   re   Úbackendsr#   rf   r$   Úensure_same_backendª   s    ÿ

þrn   TFr   rZ   zT | Array | HighLevelRecord)Úcontentr   r^   Úliker_   r   r)   c           	      C  sÚ   dd l }ddlm} ddlm} t| ||fƒs6|s6J ‚|d u sLt|tƒsLJ ‚t|tƒsZJ ‚|r¼|d urv|d u rvt|ƒ}t| |ƒr’|j	j
| ||d�S t| |ƒr®|j	j| ||d�S |r¶| S t‚nt| ||fƒsÎ|rÒ| S t‚d S )Nr   r   r   r5   )rM   Úawkward.contentsr   Úawkward.recordr   rN   r   rZ   r
   r^   r   ÚAssertionError)	ro   r   r^   rp   r_   r   Úawkwardr   r   r#   r#   r$   r`   Â   s&    

r`   c                 C  s6   ddl }t| |jj|jj|jjfƒr.| | ¡S | S dS )a	  
    Args:
        obj: an object

    Calls #ak.to_layout and returns the result iff. the object is a high-level
    Awkward object, otherwise the object is returned as-is.

    This function should be removed once scalars are properly handled by `to_layout`.
    r   N)rM   rN   r^   r   r   rL   Z	to_layout)rK   rt   r#   r#   r$   Úmaybe_highlevel_to_lowlevelä   s    
ýþ
ru   rR   r[   )rV   c           	        sF  ddl m‰ m‰m‰m}m‰m‰ ddlm‰m	‰ t
| ƒ‰d‡ ‡‡‡‡‡‡‡‡‡	f
dd„	‰| jt d¡krptdƒ‚|dkr˜| jdkr˜td	t| ƒj› d
�ƒ‚t| tjjƒrètj | ¡}tj | ¡} t|tjƒrìt|jƒdkrìd‰	| d¡}nd }|�r | jjd u �rˆ| |ƒ}n6g }| jjD ]}| ˆ| | |ƒ¡ �q||| jjƒ}|S )Nr   )ÚByteMaskedArrayÚ	ListArrayÚ
NumpyArrayÚRecordArrayÚRegularArrayÚUnmaskedArray)ÚIndex8ÚIndex64c           	        s„  ˆ
rJt | jƒdkrJd| jdd …  }ˆˆ	ˆ | |¡|ƒ| jd | jd ƒS t | jƒdkrdˆ | d¡} | jjdk�r,ˆtu s~J ‚|  d¡}|jj}tjdt |ƒ| |tj	d�}t 
|tj |¡¡}ˆˆ|ƒˆ|ƒˆ| d	¡d
ditd�d
did�}tt | jƒd ddƒD ]"}ˆ|| j| | j|d  ƒ}�qnÞ| jjdk�rˆtu �sHJ ‚tj |  d¡dd¡}|jj}tjdt |ƒ| |tj	d�}t 
|tj |¡¡}ˆˆ|ƒˆ|ƒˆ| d	¡d
ditd�d
did�}tt | jƒd ddƒD ]"}ˆ|| j| | j|d  ƒ}�qÜnˆ| ƒ}|d u �r|S |du �s6t|tjƒ�rn|�snt | jƒdk�rNˆ|ƒS ‡‡‡‡ fdd„‰ ˆ | ¡ ƒS nˆˆ|ƒ|dd�S d S )Nr*   )rJ   é   r   )r*   ÚSrJ   )ÚdtypeÚu1Z	__array__Úbyte)Ú
parametersr   Ú
bytestring)rƒ   ÚUzutf-8ÚsurrogateescapeÚcharÚstringFc                   s.   t | ˆ ƒrˆ| ƒS ˆˆ| jƒ| jt| ƒƒS d S r>   )rN   ro   Úsizer2   )Úx)rx   rz   r{   Úattachr#   r$   r‹   N  s    
z.from_arraylib.<locals>.recurse.<locals>.attach)Z
valid_when)r2   ÚshapeÚreshaper€   ÚkindÚnumpyÚitemsizeZarangeÚnpZint64Úaddr‡   Zstr_lenÚviewÚnumpy_backendÚrangeÚencoderN   Zbool_Zto_RegularArray)	ÚarrayÚmaskZ	new_shapeZasbytesr�   ZstartsÚstopsÚdataÚi©
rv   r}   r|   rw   rx   rz   r{   ZnplikeÚrecurserY   )r‹   r$   r�     sl    ý
ýø
"ýø
"
zfrom_arraylib.<locals>.recurseÚOz9Awkward Array does not support arrays with object dtypes.rQ   zEncountered a scalar (z.), but scalar conversion/promotion is disabledr*   TrJ   )N)rq   rv   rw   rx   ry   rz   r{   Zawkward.indexr|   r}   r   r€   r‘   Ú	TypeErrorÚndimÚtyper   rN   r�   ÚmaZMaskedArrayZgetmaskZgetdataZndarrayr2   rŒ   r�   ÚnamesrO   )	r—   rY   ZrecordarrayrV   ry   r˜   ri   ÚcontentsÚnamer#   rœ   r$   Úfrom_arraylibý   s0      Jÿr¦   r   Úintz
int | None)ri   ÚaxisÚdepthr)   c                 C  sf   ddl m} t| |ƒr4|dkr&tdƒ‚t| j||ƒS |dkr@|S | j\}}|s^|| | d S d S d S )Nr   r   z/Record type at axis=0 is a scalar, not an arrayr*   )rr   r   rN   r   Úmaybe_posaxisZ_arrayZbranch_depth)ri   r¨   r©   r   Zis_branchingZadditional_depthr#   r#   r$   rª   w  s    

rª   )N)NTNFN)rR   )3Ú
__future__r   Úcollections.abcr   r   Útypingr   Zawkward._backends.backendr   Zawkward._backends.dispatchr   r   Zawkward._backends.numpyr	   Zawkward._behaviorr
   Zawkward._nplikes.dispatchr   Zawkward._nplikes.numpyr   Zawkward._nplikes.numpy_liker   Zawkward._typingr   r   r   r   r   Zawkward.errorsr   rq   r   Úinstancer‘   r�   r”   r   rM   r   r   ZHighLevelRecordr   r%   r&   r3   r4   rn   r`   ru   r¦   rª   r#   r#   r#   r$   Ú<module>   sL    ÿqÿ     ú" üz