§
    ŠŠtjÙg ã                   ój  — d dl Z d dlZd dlZd dlZd dlZd dl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mZmZmZmZ d dl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'm(Z(m)Z) ddl*m+Z+m,Z,m-Z-m.Z. ddl/m0Z0m1Z1m2Z2 g d¢Z3 ej4        e5¦  «        Z6 G d„ de7e¦  «        Z8e8j9        Z9e8j:        Z:e8j;        Z;e8j<        Z<e8j=        Z=e8j>        Z>e8j?        Z?e8j@        Z@e8jA        ZAe8jB        ZBe8jC        ZCe8jD        ZD e.d ¦  «        ZEe9ZFe:ZGe;ZHeBZI ejJ        d¦  «        ZK G d„ de¦  «        ZLedeLde7fd„¦   «         ZM	 d^deNeOePeLdz           f         deOdz  de7fd„ZQ G d„ de¦  «        ZRd^dePejS                 d e7dz  dePejT                 fd!„ZU	 d^dePejS                 d e7dz  deNeOePejT                 f         fd"„ZVd#ePejT                 fd$„ZW G d%„ d&eR¦  «        ZX G d'„ d(eX¦  «        ZY G d)„ d*eX¦  «        ZZ G d+„ d,eX¦  «        Z[d-e8de\fd.„Z]d/ePeLdz           d0eOdePeLdz           fd1„Z^	 d_d3ePeLdz           d4eOdePeL         fd5„Z_d3ePeLdz           dePeL         fd6„Z`d3eNeOePeL         f         d7eeOgeOf         d8eOdeNeOePeL         f         fd9„Zad/eNeOePeL         f         d7eeOgeOf         deNeOePeL         f         fd:„Zbd/eNeOePeLdz           f         d;eOd8eOd<eOdeNeOeOf         f
d=„Zc G d>„ d?eR¦  «        Zde G d@„ dA¦  «        ¦   «         Ze G dB„ dCe¦  «        Zf G dD„ dEed¦  «        Zg G dF„ dGeg¦  «        Zh	 	 d`dI„Zi	 dadKeOdLeOdMeOd;eOd0eOdNeOdeOfdO„Zj G dP„ dQeg¦  «        Zk G dR„ dSeg¦  «        Zl G dT„ dUeg¦  «        Zm G dV„ dWeg¦  «        ZndXe7fdY„Zod7eeOgeOf         d8eOfdZ„Zpd[„ Zqd\ePe0         dXe7fd]„ZrdS )bé    N)ÚABCÚabstractmethod)ÚCounterÚdefaultdict)ÚCallable)Ú	dataclass)ÚEnum)Ú	lru_cache)ÚAnyÚcastÚLiteralÚ
NamedTupleÚProtocol)ÚOptimizedModule)Ú
FSDPModuleÚUnshardHandle)Ú_Loss)Úrecord_functioné   )Úgenerate_rank_to_stage_mappingÚgenerate_stage_to_rank_mappingÚInferenceMode)Ú_split_tensorÚmerge_chunksÚsplit_args_kwargs_into_chunksÚTensorChunkSpec)Ú_PipelineStageBaseÚ	_RecvInfoÚPipelineStage)
Úget_schedule_classÚPipelineScheduleSingleÚPipelineScheduleMultiÚSchedule1F1BÚScheduleGPipeÚScheduleInterleaved1F1BÚScheduleLoopedBFSÚScheduleInterleavedZeroBubbleÚScheduleZBVZeroBubbleÚScheduleDualPipeVc                   ó^   — e Zd ZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZdZededd fd„¦   «         ZdS )Ú_ComputationTypeÚFÚIÚWÚUNSHARDÚRESHARDÚSEND_FÚRECV_FÚSEND_BÚRECV_BÚBÚOVERLAP_F_BÚREDUCE_GRADÚactionÚreturnc                 ól   — 	 t          | ¦  «        S # t          $ r}t          d| › �¦  «        |‚d }~ww xY w)NúInvalid computation type )r+   Ú
ValueErrorÚRuntimeError)r8   Úexcs     úd/var/www/html/CA-Chatbot/venv/lib/python3.11/site-packages/torch/distributed/pipelining/schedules.pyÚfrom_strz_ComputationType.from_strE   sR   € ð	NÝ# FÑ+Ô+Ð+øÝð 	Nð 	Nð 	NÝÐC¸6ÐCÐCÑDÔDÈ#ÐMøøøøð	Nøøøs   ‚ ‘
3›.®3N)Ú__name__Ú
__module__Ú__qualname__ÚFORWARDÚBACKWARD_INPUTÚBACKWARD_WEIGHTr/   r0   r1   r2   r3   r4   ÚFULL_BACKWARDr6   r7   ÚstaticmethodÚstrr@   © ó    r?   r+   r+   6   s…   € € € € € à€GØ€NØ€OØ€GØ€GØ€FØ€FØ€FØ€FØ€MØ€KØ€KàðN˜ð NÐ!3ð Nð Nð Nñ „\ðNð Nð NrK   r+   zK(\d+)(F|I|B|W|UNSHARD|RESHARD|REDUCE_GRAD|SEND_F|RECV_F|SEND_B|RECV_B)(\d*)c                   óœ   — e Zd ZU eed<   eed<   dZedz  ed<   dZed         dz  ed<   d„ Z	d„ Z
ed	efd
„¦   «         Zedefd„¦   «         ZdS )Ú_ActionÚstage_indexÚcomputation_typeNÚmicrobatch_index)rM   .Úsub_actionsc                 ó*   — |                       ¦   «         S ©N)Ú__repr__©Úselfs    r?   Ú__str__z_Action.__str__s   s   € Ø�}Š}‰ŒÐrK   c                 ó  — | j         �6d„ | j         D ¦   «         }dd                     |¦  «        › d| j        j        › �S t	          | j        ¦  «        }|| j        j        z  }| j        �|t	          | j        ¦  «        z  }|S )Nc                 ó,   — g | ]}t          |¦  «        ‘ŒS rJ   )Úrepr)Ú.0Ú
sub_actions     r?   ú
<listcomp>z$_Action.__repr__.<locals>.<listcomp>y   s    € ÐTÐTÐT°Z¥ ZÑ 0Ô 0ÐTÐTÐTrK   ú(ú;ú))rQ   ÚjoinrO   ÚvaluerI   rN   rP   )rV   Úsub_action_reprsÚrepr_strs      r?   rT   z_Action.__repr__v   sŽ   € ØÔÐ'àTÐTÀ4ÔCSÐTÑTÔTÐØQ�s—x’xÐ 0Ñ1Ô1ÐQÐQ°DÔ4IÔ4OÐQÐQÐQå˜4Ô+Ñ,Ô,ˆHà˜Ô-Ô3Ñ3ˆHØÔ$Ð0Ø�C Ô 5Ñ6Ô6Ñ6�ØˆOrK   r9   c                 óP   — | j         t          t          t          t          t
          fv S rS   )rO   rD   rG   rE   rF   r6   rU   s    r?   Úis_compute_opz_Action.is_compute_opƒ   s&   € àÔ$ÝÝÝÝÝð)
ð 
ð 	
rK   Úaction_stringc                 ód  — |                       ¦   «         } | dk    rdS |                      d¦  «        rÝd| v rÙ|                      d¦  «        }| d|…         }| |dz   d…         }g }|                      ¦   «         r[|                     d¦  «        D ]E}t                               |                      ¦   «         ¦  «        }|�|                     |¦  «         ŒFt	          dt                               |¦  «        d|rt          |¦  «        nd¬¦  «        S t           
                    | ¦  «        x}rl|                     ¦   «         \  }}	}
t	          t          |¦  «        t                               |	¦  «        t          |
¦  «        rt          |
¦  «        nd¦  «        S | dk    rdS t          d	| › d
�¦  «        ‚)zž
        Reverse of __repr__

        String should be formatted as [stage][action type][(microbatch)]
            e.g. `2F0`, `1UNSHARD`, `3SEND_F1`
        Ú Nr^   r`   r   r_   éÿÿÿÿ)rN   rO   rP   rQ   zInvalid action string: zD, should be formatted as [stage][action type][(microbatch)] e.g. 2F0)ÚstripÚ
startswithÚfindÚsplitrM   r@   Úappendr+   ÚtupleÚ_action_regexÚmatchÚgroupsÚintÚlenr=   )rg   Úbracket_endÚsub_partÚcomputation_type_partrQ   Úsub_strr\   rr   rN   rO   rP   s              r?   r@   z_Action.from_str�   sè  € ð &×+Ò+Ñ-Ô-ˆØ˜BÒÐØ�4ð ×#Ò# CÑ(Ô(ð 	¨S°MÐ-AÐ-Aà'×,Ò,¨SÑ1Ô1ˆKØ$Ø�+�ôˆHð %2Ø˜a‘Ð!Ð!ô%Ð!ð
 ˆKØ�~Š~ÑÔð 7Ø'Ÿ~š~¨cÑ2Ô2ð 7ð 7�GÝ!(×!1Ò!1°'·-²-±/´/Ñ!BÔ!B�JØ!Ð-Ø#×*Ò*¨:Ñ6Ô6Ð6øõ ØÝ!1×!:Ò!:Ð;PÑ!QÔ!QØ!%Ø2=ÐG�E +Ñ.Ô.Ð.À4ð	ñ ô ð õ "×'Ò'¨Ñ6Ô6Ð6ˆ5ð 	Ø>C¿lºl¹n¼nÑ;ˆKÐ)Ð+;ÝÝ�KÑ Ô Ý ×)Ò)Ð*:Ñ;Ô;Ý),Ð-=Ñ)>Ô)>ÐH•Ð$Ñ%Ô%Ð%ÀDñô ð ð
 ˜bÒ Ð Ø�4ÝØy mÐyÐyÐyñ
ô 
ð 	
rK   )rA   rB   rC   rt   Ú__annotations__r+   rP   rQ   rp   rW   rT   ÚpropertyÚboolrf   rH   rI   r@   rJ   rK   r?   rM   rM   m   sÉ   € € € € € € ØÐÐÑØ&Ð&Ð&Ñ&Ø#'Ð�c˜D‘jÐ'Ð'Ñ'Ø04€K��~Ô&¨Ñ-Ð4Ð4Ñ4ðð ð ðð ð ð ð
˜tð 
ð 
ð 
ñ „Xð
ð ð3
 ð 3
ð 3
ð 3
ñ „\ð3
ð 3
ð 3
rK   rM   r8   r9   c                 ó&   — dt          | ¦  «        › �S )NzPP:©rI   )r8   s    r?   Ú_get_profiler_function_namer   Ä   s   € à•�V‘”ÐÐÐrK   Úpipeline_orderÚerror_step_numberc                 óD  ‡ ‡‡‡— t          j        ‰ ¦  «        Š ‰ D ]@}t          t          ‰ |         ¦  «        ¦  «        D ]}‰ |         |         €d‰ |         |<   ŒŒAt	          d„ ‰                      ¦   «         D ¦   «         ¦  «        Šˆfd„t          ‰¦  «        D ¦   «         }ˆˆ fd„t          ‰ ¦  «        D ¦   «         }t          t          j	        |ddiŽ¦  «        }t          ‰ ¦  «        }d„ t          |¦  «        D ¦   «         }d„ t          |g|¢R Ž D ¦   «         Šd	t          |d
         ¦  «        dz   z  d	                     ˆfd„t          |¦  «        D ¦   «         ¦  «        z   }	ˆˆfd„t          ||¦  «        D ¦   «         }
|	dz   d                     |
¦  «        z   dz   }|S )zü
    Formats the pipeline order in a timestep (row) x rank (column) grid of actions
    and returns the formatted string.

    If `error_step_number` is passed in, an additional label will be added to signify which step
    that it is erroring on.
    Nri   c              3   ó4   K  — | ]}t          |¦  «        V — Œd S rS   )ru   )r[   Úactionss     r?   ú	<genexpr>z)_format_pipeline_order.<locals>.<genexpr>à   s(   è è € ÐHÐH W•C˜‘L”LÐHÐHÐHÐHÐHÐHrK   c                 ó”   •— g | ]D}d t          |¦  «                             t          t          ‰dz
  ¦  «        ¦  «        ¦  «        z   ‘ŒES )zStep r   )rI   Úzfillru   )r[   ÚiÚ	num_stepss     €r?   r]   z*_format_pipeline_order.<locals>.<listcomp>á   sQ   ø€ ð ð ð Ø<=ˆ•#�a‘&”&—,’,�s¥3 y°1¡}Ñ#5Ô#5Ñ6Ô6Ñ7Ô7Ñ7ðð ð rK   c                 óD   •— g | ]}‰                      |d g‰z  ¦  «        ‘ŒS )ri   )Úget)r[   Úkeyr‰   r€   s     €€r?   r]   z*_format_pipeline_order.<locals>.<listcomp>å   s=   ø€ ð ð ð Ø69ˆ×Ò˜3   yÑ 0Ñ1Ô1ðð ð rK   Ú	fillvaluec                 ó2   — g | ]}d t          |¦  «        z   ‘ŒS )úRank r~   )r[   rˆ   s     r?   r]   z*_format_pipeline_order.<locals>.<listcomp>í   s#   € Ð>Ð>Ð>¨�7�S ™VœVÑ#Ð>Ð>Ð>rK   c                 ó@   — g | ]}t          d „ |D ¦   «         ¦  «        ‘ŒS )c              3   óV   K  — | ]$}|�t          t          |¦  «        ¦  «        ndV — Œ%d S )Nr   )ru   rI   )r[   Úitems     r?   r…   z4_format_pipeline_order.<locals>.<listcomp>.<genexpr>ð   s7   è è € ÐFÐF¸$˜dÐ.�C•�D‘	”	‰NŒNˆN°AÐFÐFÐFÐFÐFÐFrK   )Úmax)r[   Úcols     r?   r]   z*_format_pipeline_order.<locals>.<listcomp>ï   s?   € ð ð ð àõ 	ÐFÐFÀ#ÐFÑFÔFÑFÔFðð ð rK   ú r   é   c              3   ó8   •K  — | ]\  }}|d ‰|         › �›V — ŒdS ©ú<NrJ   )r[   rˆ   ÚlabelÚmax_lengthss      €r?   r…   z)_format_pipeline_order.<locals>.<genexpr>ô   sJ   øè è € ð <ð <Ù)1¨¨Eˆ5Ð$�;˜q”>Ð$Ð$Ð$ð<ð <ð <ð <ð <ð <rK   c           	      óâ   •— g | ]k\  }}|› d �d                      ˆfd„t          |¦  «        D ¦   «         ¦  «        z   ‰�-t          |                     ¦   «         d         ¦  «        ‰k    rdndz   ‘ŒlS )z: r•   c              3   óR   •K  — | ]!\  }}t          |¦  «        d ‰|         › �›V — Œ"dS r˜   r~   )r[   rˆ   r’   r›   s      €r?   r…   z4_format_pipeline_order.<locals>.<listcomp>.<genexpr>ú   s?   øè è € ÐRÐR¹¸¸4•c˜$‘i”iÐ3 +¨a¤.Ð3Ð3Ð3ÐRÐRÐRÐRÐRÐRrK   Nr   z <-- ERROR HEREri   )ra   Ú	enumeratert   rn   )r[   rš   Úrowr�   r›   s      €€r?   r]   z*_format_pipeline_order.<locals>.<listcomp>ø   s    ø€ ð 
ð 
ð 
ñ ˆE�3ð ˆˆˆØ
�(Š(ÐRÐRÐRÐRÅ9ÈSÁ>Ä>ÐRÑRÔRÑ
RÔ
Rñ	Sð !Ð,Ý�E—K’K‘M”M !Ô$Ñ%Ô%Ð):Ò:Ð:ð Ðð ñ	
ð
ð 
ð 
rK   ú
)ÚcopyÚdeepcopyÚrangeru   r“   ÚvaluesÚsortedÚlistÚ	itertoolsÚzip_longestÚzipra   rž   )r€   r�   Úrankrˆ   Ústep_labelsÚrank_actionsÚtransposed_actionsÚ	num_ranksÚrank_labelsÚ
header_rowÚformatted_rowsÚformatted_tabler›   r‰   s   ``          @@r?   Ú_format_pipeline_orderr³   É   s9  øøøø€ õ ”] >Ñ2Ô2€Nð ð -ð -ˆÝ•s˜>¨$Ô/Ñ0Ô0Ñ1Ô1ð 	-ð 	-ˆAØ˜dÔ# AÔ&Ð.à*,�˜tÔ$ QÑ'øð	-õ ÐHÐH°×0EÒ0EÑ0GÔ0GÐHÑHÔHÑHÔH€Iðð ð ð ÝAFÀyÑAQÔAQðñ ô €Kðð ð ð ð Ý=CÀNÑ=SÔ=Sðñ ô €Lõ
 �iÔ3°\ÐPÈRÐPÐPÑQÔQÐå�NÑ#Ô#€IØ>Ð>­U°9Ñ-=Ô-=Ð>Ñ>Ô>€Kðð å�{Ð8Ð%7Ð8Ð8Ð8ðñ ô €Kð
 �˜K¨œNÑ+Ô+¨aÑ/Ñ0°3·8²8ð <ð <ð <ð <Ý5>¸{Ñ5KÔ5Kð<ñ <ô <ñ 4ô 4ñ €Jð
ð 
ð 
ð 
ð 
õ ˜kÐ+=Ñ>Ô>ð
ñ 
ô 
€Nð ! 4Ñ'¨$¯)ª)°NÑ*CÔ*CÑCÀdÑJ€OØÐrK   c                   óì  — e Zd Z	 	 	 	 	 d)dededej        f         dz  deedf         dz  de	e
ef         dz  de	e
ef         ee         z  dz  d	efd
„Z	 d*d„Zd„ Zd„ Zdee         dededdfd„Z	 d*dee         deedf         ez  de	e
ef         dz  dededede	e
ef         dz  deeef         fd„Ze	 	 	 	 	 	 d+dedz  dedz  dedz  dedz  dede	e
ef         dz  fd„¦   «         Zeddddd œdedz  de	e
ef         dz  fd!„¦   «         Zddd"œdedz  fd#„Z	 	 	 	 d,dedz  dedz  dedz  dedz  deeef         f
d$„Zd*d%„Z	 d*deedf         de	e
ef         dz  fd&„Zd'ee         defd(„ZdS )-Ú_PipelineScheduleNTÚn_microbatchesÚloss_fn.Úargs_chunk_specÚkwargs_chunk_specÚoutput_merge_specÚscale_gradsc                 óÐ   — || _         || _        || _        || _        || _        || _        	 | j        d u| _        g | _        t           	                    d| j
        j        ¦  «         d S )NzUsing %s)Ú_n_microbatchesÚ_loss_fnr»   Ú_args_chunk_specÚ_kwargs_chunk_specÚ_output_merge_specÚ_has_backwardÚ_internal_lossesÚloggerÚinfoÚ	__class__rA   )rV   r¶   r·   r¸   r¹   rº   r»   s          r?   Ú__init__z_PipelineSchedule.__init__	  sv   € ð  .ˆÔØˆŒð 'ˆÔð !0ˆÔà"3ˆÔØ"3ˆÔð	ð "œ]°$Ð6ˆÔð 57ˆÔÝ�Š�J ¤Ô 7Ñ8Ô8Ð8Ð8Ð8rK   c                 ó˜   — |j         r@| j        �;|                      |||         |¦  «        }| j                             |¦  «         d S d S d S rS   )Úis_lastr¾   Ú_compute_lossrÃ   ro   )rV   ÚstageÚoutputÚ
target_mbsÚmb_indexÚloss_kwargsÚlosss          r?   Ú_maybe_compute_lossz%_PipelineSchedule._maybe_compute_loss+  s^   € ð Œ=ð 	/˜Tœ]Ð6Ø×%Ò% f¨j¸Ô.BÀKÑPÔPˆDØÔ!×(Ò(¨Ñ.Ô.Ð.Ð.Ð.ð	/ð 	/Ð6Ð6rK   c                 óì   — d|cxk    ot          | j        ¦  «        k     nc }|j        r| j        �|r| j        |         S t          | j        ¦  «        dk    r|st	          d|› d| j        › �¦  «        ‚d S )Nr   zLoss for microbatch z6 is not available. Available losses for microbatches: )ru   rÃ   rÉ   r¾   r=   )rV   rË   rÎ   Úvalid_indexs       r?   Ú_maybe_get_lossz!_PipelineSchedule._maybe_get_loss2  s¬   € Ø˜8Ð@Ð@Ò@Ð@¥c¨$Ô*?Ñ&@Ô&@Ò@Ð@Ð@Ð@ˆØŒ=ð 	˜Tœ]Ð6¸;Ð6ØÔ(¨Ô2Ð2Ý�Ô&Ñ'Ô'¨1Ò,Ð,°[Ð,ÝðN xð Nð NØ6:Ô6KðNð Nñô ð ð
 �4rK   c                 ó�  — t          |t          ¦  «        s|g}t          d„ |D ¦   «         ¦  «        }|ry|�wt          | j        ¦  «        | j        k    r,t          d| j        › dt          | j        ¦  «        › �¦  «        ‚|                     ¦   «          |                     | j        ¦  «         | j                             ¦   «          dS )zB
        Update the losses to those in the internal state
        c              3   ó$   K  — | ]}|j         V — Œd S rS   ©rÉ   ©r[   rË   s     r?   r…   z3_PipelineSchedule._update_losses.<locals>.<genexpr>E  s$   è è € Ð!DÐ!D°E %¤-Ð!DÐ!DÐ!DÐ!DÐ!DÐ!DrK   Nú
Expecting z losses but got )	Ú
isinstancer¦   Úanyru   rÃ   r½   r=   ÚclearÚextend)rV   ÚstagesÚlossesÚcontains_last_stages       r?   Ú_update_lossesz _PipelineSchedule._update_losses>  sÔ   € õ
 ˜&¥$Ñ'Ô'ð 	Ø�XˆFÝ!Ð!DÐ!D¸VÐ!DÑ!DÔ!DÑDÔDÐð ð 		1 6Ð#5Ý�4Ô(Ñ)Ô)¨TÔ-AÒAÐAÝ"Øc Ô!5ÐcÐcÅsÈ4ÔK`ÑGaÔGaÐcÐcñô ð ð
 �LŠL‰NŒNˆNà�MŠM˜$Ô/Ñ0Ô0Ð0àÔ×#Ò#Ñ%Ô%Ð%Ð%Ð%rK   rÞ   Úhas_backwardÚp2p_doner9   c                 óÚ  — t          d„ |D ¦   «         ¦  «        �rd}t          t          t                   |¦  «        D ]}|                     ||¬¦  «        }Œ|}d}t          t          t          t                   |¦  «        ¦  «        D ]`}|                     |¬¦  «        }|€t          d¦  «        ‚|                     ¦   «         dk    rt          j
        nt          j        }||_        Œat                               d|r|j        ndt!          |¦  «        ¦  «         dS |sLg }|D ])}|                     |                     ¦   «         ¦  «         Œ*t'          t)          |¦  «        ¦  «         dS dS )	u–  Run the P2P warm-up protocol for the given stages.

        For ``PipelineStage`` instances this executes the forward/backward vote
        protocol (which warms up 2-rank sub-communicators) and sets each
        stage's ``_inference_mode``.  For other stage types it falls back to
        the legacy ``_get_init_p2p_neighbors_ops`` + ``_batch_p2p`` path.

        Args:
            stages: The pipeline stages owned by this rank.
            has_backward: Whether the schedule includes a backward pass.
            p2p_done: ``True`` if P2P neighbours have already been initialised
                (avoids redundant init on evalâ†”train mode switches).
        c              3   ó@   K  — | ]}t          |t          ¦  «        V — Œd S rS   )rÚ   r   rØ   s     r?   r…   z0_PipelineSchedule._warmup_p2p.<locals>.<genexpr>h  s,   è è € ÐDÐD°E�z˜%¥Ñ/Ô/ÐDÐDÐDÐDÐDÐDrK   N)Úreceived_acc)Úreceived_resultzP2P warm-up voting failedr   z1Rank determined inference_mode=%s for %d stage(s)ÚNone)Úallr   r¦   r   Ú_warmup_forward_voteÚreversedÚ_warmup_backward_resultr=   r’   r   ÚSTATICÚDYNAMICÚ_inference_moderÄ   Údebugrb   ru   rÝ   Ú_get_init_p2p_neighbors_opsÚ_wait_batch_p2pÚ
_batch_p2p)	rV   rÞ   râ   rã   ÚaccrË   ÚresultÚdetermined_modeÚall_opss	            r?   Ú_warmup_p2pz_PipelineSchedule._warmup_p2pU  s—  € õ& ÐDÐD¸VÐDÑDÔDÑDÔDñ 	1Ø'+ˆCÝ�d¥=Ô1°6Ñ:Ô:ð Qð Q�Ø×0Ò0°ÈCÐ0ÑPÔP��Ø*-ˆFØ48ˆOÝ!¥$¥t­MÔ':¸FÑ"CÔ"CÑDÔDð 	8ð 	8�Ø×6Ò6ÀvÐ6ÑNÔN�Ø�>Ý&Ð'BÑCÔCÐCð —{’{‘}”}¨Ò)Ð)õ "Ô(Ð(å&Ô.ð  ð
 )8�Ô%Ð%Ý�LŠLØCØ)8ÐD�Ô%Ð%¸fÝ�F‘”ñô ð ð ð ð
 ð 	1Ø(*ˆGØð Dð D�Ø—’˜u×@Ò@ÑBÔBÑCÔCÐCÐCÝ�J wÑ/Ô/Ñ0Ô0Ð0Ð0Ð0ð		1ð 	1rK   ÚargsÚkwargsÚtargetÚfwd_initializedÚbwd_initializedrÏ   c           	      ó  ‡— |}|r| j         |k    rd}d}| }	| j         o| }
|	s|
s||fS |	r|                      || j         |¦  «         t          d„ |D ¦   «         ¦  «        }|r|d         j        ndŠ‰�9t	          ˆfd„|D ¦   «         ¦  «        sd„ |D ¦   «         }t          d|› �¦  «        ‚t          j                             |‰¬¦  «        5  |	r7d}|D ]0}|j	        r|n|}| 
                    | j        ||| j         ¬	¦  «        }Œ1d
}|
r:d}t          |¦  «        D ]&}|                     | j        | j        |||¬¦  «        }Œ'd
}ddd¦  «         n# 1 swxY w Y   |D ]+}t          |t           ¦  «        r|                     ¦   «          Œ,||fS )u'  Common stage initialization shared by Single and Multi schedules.

        Handles mode-change detection (evalâ†”train), P2P warm-up, RNG forking,
        forward / backward metadata inference, and FSDP cleanup.

        Returns the updated ``(fwd_initialized, bwd_initialized)`` flags.
        Fc                 ó„   — h | ]=}t          j        |j        ¦  «        j        d k    ¯$t          j        |j        ¦  «        ’Œ>S )Úcpu)ÚtorchÚdeviceÚtyperØ   s     r?   ú	<setcomp>z:_PipelineSchedule._initialize_pp_stages.<locals>.<setcomp>³  sH   € ð ð ð àÝ”< ¤Ñ-Ô-Ô2°eÒ;Ð;õ ”˜Uœ\Ñ*Ô*à;Ð;Ð;rK   r   Nc              3   ó.   •K  — | ]}|j         ‰k    V — Œd S rS   ©r  )r[   r  Údevice_types     €r?   r…   z:_PipelineSchedule._initialize_pp_stages.<locals>.<genexpr>»  s;   øè è € ð /
ð /
Ø+1ˆFŒK˜;Ò&ð/
ð /
ð /
ð /
ð /
ð /
rK   c                 ó   — h | ]	}|j         ’Œ
S rJ   r  )r[   r  s     r?   r  z:_PipelineSchedule._initialize_pp_stages.<locals>.<setcomp>¾  s   € Ð>Ð>Ð>¨F˜FœKÐ>Ð>Ð>rK   zOAll stages must have the same device type for RNG forking. Found device types: )Údevicesr  )râ   T)r·   rû   Úreceived_grad_metarÏ   )rÂ   rø   r¦   r  ré   ÚAssertionErrorr  ÚrandomÚfork_rngÚis_firstÚ_prepare_forward_infrar½   rë   Ú_prepare_backward_infrar¾   rÚ   r   Ú _post_metadata_inference_cleanup)rV   rÞ   rù   rú   rû   rü   rý   rÏ   rã   Ú	needs_fwdÚ	needs_bwdr	  Údevice_typesÚnext_stage_argsrË   Ú
stage_argsÚprev_stage_grad_metar  s                    @r?   Ú_initialize_pp_stagesz'_PipelineSchedule._initialize_pp_stages�  sª  ø€ ð( #ˆØð 	$ Ô 2°oÒ EÐ EØ#ˆOØ#ˆOà'Ð'ˆ	ØÔ&Ð>¨Ð+>ˆ	àð 	4 ð 	4Ø" OÐ3Ð3àð 	CØ×Ò˜V TÔ%7¸ÑBÔBÐBõ ðð à#ðñ ô ñ
ô 
ˆð *1Ð:�g˜a”j”o�o°dˆàÐ"­3ð /
ð /
ð /
ð /
Ø5<ð/
ñ /
ô /
ñ ,
ô ,
Ð"ð ?Ð>°gÐ>Ñ>Ô>ˆLÝ ð6Ø'3ð6ð 6ñô ð õ Œ\×"Ò"¨7ÀÐ"ÑLÔLð 	'ð 	'Øð 
'Ø'+�Ø#ð ð �EØ).¬Ð!L  ¸_�JØ&+×&BÒ&BØÔ,Ø"ØØ%)Ô%7ð	 'Cñ 'ô '�O�Oð #'�àð 
'Ø,0Ð$Ý% fÑ-Ô-ð ð �EØ+0×+HÒ+HØÔ,Ø $¤Ø%Ø+?Ø$/ð ,Iñ ,ô ,Ð(Ð(ð #'�ð/	'ð 	'ð 	'ñ 	'ô 	'ð 	'ð 	'ð 	'ð 	'ð 	'ð 	'øøøð 	'ð 	'ð 	'ð 	'ð2 ð 	9ð 	9ˆEÝ˜%¥Ñ/Ô/ð 9Ø×6Ò6Ñ8Ô8Ð8øà Ð/Ð/s   ÃA6EÅEÅEÚarg_mbsÚ	kwarg_mbsrÍ   rß   Úreturn_outputsc                 ó   — t           ‚)a˜  
        Run one iteration of the pipeline schedule with list of microbatches.
        Will go through all the microbatches according to the schedule
        implementation.

        Args:
            microbatches: list of microbatch args.
            return_outputs: whether to return the outputs from the last stage.
            loss_kwargs: extra keyword arguments forwarded to the loss function.
        ©ÚNotImplementedError)rV   r  r  rÍ   rß   r  rÏ   s          r?   Ú_step_microbatchesz$_PipelineSchedule._step_microbatchesâ  s
   € õ( "Ð!rK   ©rû   rß   r  rÏ   c                ó   — t           ‚)á‚  
        Run one iteration of the pipeline schedule with *whole-batch* input.
        Will chunk the input into microbatches automatically, and go through the
        microbatches according to the schedule implementation.

        args: positional arguments to the model (as in non-pipeline case).
        kwargs: keyword arguments to the model (as in non-pipeline case).
        target: target for the loss function.
        losses: a list to store the losses for each microbatch.
        return_outputs: whether to return the outputs from the last stage.
        loss_kwargs: extra keyword arguments forwarded to the loss function.
        r  )rV   rû   rß   r  rÏ   rù   rú   s          r?   Ústepz_PipelineSchedule.stepø  s
   € õ, "Ð!rK   ©rû   rß   c                óf   — | j         }	 d| _          | j        |||dœ|¤Ž|| _         S # || _         w xY w)aÞ  
        Run one iteration of the pipeline schedule with *whole-batch* input.
        Will chunk the input into microbatches automatically, and go through the
        microbatches, calling forward only.

        args: positional arguments to the model (as in non-pipeline case).
        kwargs: keyword arguments to the model (as in non-pipeline case).
        target: target values for the loss function.
        losses: a list to store the losses for each microbatch.
        Fr$  )rÂ   r#  )rV   rû   rß   rù   rú   Úoriginal_has_backwards         r?   Úevalz_PipelineSchedule.eval  sW   € ð !%Ô 2Ðð	7Ø!&ˆDÔØ�4”9˜d¨6¸&ÐKÐKÀFÐKÐKð "7ˆDÔÐøÐ!6ˆDÔÐ6Ð6Ð6Ð6s   ‰' §	0c                 ó  ‡ — dt           fˆ fd„}|� ||d¦  «         ndg‰ j        z  }|� ||d¦  «         ni g‰ j        z  }|� ||d¦  «         |�4t          |t          ¦  «        st	          dt          |¦  «        › �¦  «        ‚||fS )	z*
        Pre-process/check inputs
        Únamec           
      óø   •— t          | t          ¦  «        s!t          |› dt          | ¦  «        › �¦  «        ‚t	          | ¦  «        ‰j        k    r*t          d‰j        › d|› dt	          | ¦  «        › �¦  «        ‚d S )Nz must be a list but got a rÙ   r•   z	 but got )rÚ   r¦   Ú	TypeErrorr  ru   r½   r<   )Úmbsr)  rV   s     €r?   Úcheck_type_and_lenz;_PipelineSchedule._check_inputs.<locals>.check_type_and_len/  sŠ   ø€ Ý˜c¥4Ñ(Ô(ð PÝ 4Ð NÐ NÅ4ÈÁ9Ä9Ð NÐ NÑOÔOÐOÝ�3‰xŒx˜4Ô/Ò/Ð/Ý ØQ Ô!5ÐQÐQ¸ÐQÐQÅsÈ3ÁxÄxÐQÐQñô ð ð 0Ð/rK   Nr  rJ   r  rÍ   z losses must be a list but got a )rI   r½   rÚ   r¦   r+  r  )rV   r  r  rÍ   rß   r-  s   `     r?   Ú_check_inputsz_PipelineSchedule._check_inputs$  sÚ   ø€ ð	­#ð 	ð 	ð 	ð 	ð 	ð 	ð ÐØÐ˜w¨	Ñ2Ô2Ð2Ð2à�d˜TÔ1Ñ1ˆGàÐ ØÐ˜y¨+Ñ6Ô6Ð6Ð6à˜˜tÔ3Ñ3ˆIàÐ!ØÐ˜z¨<Ñ8Ô8Ð8àÐÝ˜f¥dÑ+Ô+ð SÝÐ QÅ4ÈÁ<Ä<Ð QÐ QÑRÔRÐRà˜	Ð!Ð!rK   c                 ó$   —  | j         ||fi |pi ¤ŽS rS   )r¾   )rV   rÌ   rû   rÏ   s       r?   rÊ   z_PipelineSchedule._compute_lossJ  s#   € ØˆtŒ}˜V VÐCÐC°Ð0A¸rÐCÐCÐCrK   c                 óˆ   — |s|r)t          ||| j        | j        | j        ¦  «        \  }}||fS dg| j        z  i g| j        z  fS )zj
        Splits a full-batch input into chunks (i.e. microbatches) and returns
        the chunks
        rJ   )r   r½   r¿   rÀ   )rV   rù   rú   Ú
args_splitÚkwargs_splits        r?   Ú_split_inputsz_PipelineSchedule._split_inputsM  so   € ð ð 	L�6ð 	LÝ'DØØØÔ$ØÔ%ØÔ'ñ(ô (Ñ$ˆJ˜ð ˜|Ð+Ð+ð �4˜$Ô.Ñ.°°°tÔ7KÑ0KÐKÐKrK   Úoutput_chunksc                 ó,   — t          || j        ¦  «        S )z£
        Merge output chunks back to a batch state.
        If output_merge_spec is None, the utility will merge output chunks by dimension 0 (batch dim).
        )r   rÁ   )rV   r4  s     r?   Ú_merge_outputsz _PipelineSchedule._merge_outputsd  s   € õ
 ØØÔ#ñ
ô 
ð 	
rK   ©NNNNTrS   ©NNNNTN)NNNN)rA   rB   rC   rt   r   r  ÚTensorrp   r   ÚdictrI   r   r|   rÇ   rÑ   rÔ   rá   r¦   r   rø   r  r   r  r#  r'  r.  rÊ   r3  r6  rJ   rK   r?   rµ   rµ     s   € € € € € ð 7;Ø>BØ?CØ@DØ ð 9ð  9àð 9ð ˜#˜uœ|Ð+Ô,¨tÑ3ð 9ð ˜°Ð3Ô4°tÑ;ð	 9ð
    _Ð 4Ô5¸Ñ<ð 9ð    S œ>¨E°#¬JÑ6¸Ñ=ð 9ð ð 9ð  9ð  9ð  9ðF @Dð/ð /ð /ð /ð
ð 
ð 
ð&ð &ð &ð.,1àÐ'Ô(ð,1ð ð,1ð ð	,1ð
 
ð,1ð ,1ð ,1ð ,1ðD .2ðQ0ð Q0àÐ'Ô(ðQ0ð �C˜�HŒo Ñ#ðQ0ð �S˜#�X” Ñ%ð	Q0ð
 ðQ0ð ðQ0ð ðQ0ð ˜#˜s˜(”^ dÑ*ðQ0ð 
ˆt�TˆzÔ	ðQ0ð Q0ð Q0ð Q0ðf ð  $Ø!%Ø"&Ø"Ø#Ø-1ð"ð "à˜‘ð"ð ˜$‘;ð"ð ˜4‘Kð	"ð
 �t‘ð"ð ð"ð ˜#˜s˜(”^ dÑ*ð"ð "ð "ñ „^ð"ð* ð Ø"ØØ-1ð"ð "ð "ð �t‘ð	"ð ˜#˜s˜(”^ dÑ*ð"ð "ð "ñ „^ð"ð. "&¸Tð 7ð 7ð 7¨t°d©{ð 7ð 7ð 7ð 7ð,  $Ø!%Ø"&Ø"ð$"ð $"à˜‘ð$"ð ˜$‘;ð$"ð ˜4‘Kð	$"ð
 �t‘ð$"ð 
ˆt�TˆzÔ	ð$"ð $"ð $"ð $"ðLDð Dð Dð Dð )-ðLð Là�C˜�HŒoðLð �S˜#�X” Ñ%ðLð Lð Lð Lð.
¨D°¬Ið 
¸#ð 
ð 
ð 
ð 
ð 
ð 
rK   rµ   Úp2p_opsÚdescc                 ó*  — t          | ¦  «        dk    rg S |r|› d�nd}t                               d|| ¦  «         d„ | D ¦   «         }|t          j        hk    rd„ | D ¦   «         S |t          j        hk    rd„ | D ¦   «         S t          j        | ¦  «        S )aK  
    Wrapper over batch_isend_irecv that avoids coalescing for homogeneous
    batches (all-send or all-recv).  Coalescing serializes ops on a single
    CUDA stream, which causes head-of-line blocking when independent P2P ops
    could otherwise overlap.  Mixed batches still use batch_isend_irecv for
    deadlock avoidance.
    r   z, ri   zbatch_p2p %s%sc                 ó   — h | ]	}|j         ’Œ
S rJ   )Úop©r[   Úps     r?   r  z_batch_p2p.<locals>.<setcomp>|  s   € Ð&Ð&Ð&˜�”Ð&Ð&Ð&rK   c                 óh   — g | ]/}|                      |j        |j        |j        |j        ¬ ¦  «        ‘Œ0S ))ÚgroupÚtagÚ	group_dst©r?  ÚtensorrC  rD  Ú
group_peerr@  s     r?   r]   z_batch_p2p.<locals>.<listcomp>~  óD   € ð 
ð 
ð 
àð �DŠD�” ¤¨a¬e¸q¼|ˆDÑLÔLð
ð 
ð 
rK   c                 óh   — g | ]/}|                      |j        |j        |j        |j        ¬ ¦  «        ‘Œ0S ))rC  rD  Ú	group_srcrF  r@  s     r?   r]   z_batch_p2p.<locals>.<listcomp>ƒ  rI  rK   )ru   rÄ   rð   ÚdistÚisendÚirecvÚbatch_isend_irecv)r;  r<  Údesc_strÚop_typess       r?   ró   ró   o  sÍ   € õ ˆ7�|„|�qÒÐØˆ	Ø"Ð*�$ˆ{ˆ{ˆ{ˆ{¨€HÝ
‡L‚LÐ! 8¨WÑ5Ô5Ð5à&Ð&˜gÐ&Ñ&Ô&€HØ•D”J�<ÒÐð
ð 
àð
ñ 
ô 
ð 	
ð •D”J�<ÒÐð
ð 
àð
ñ 
ô 
ð 	
õ
 Ô! 'Ñ*Ô*Ð*rK   c                 ó  — t          t          ¦  «        }i }t          | ¦  «        dk    r|S | D ]"}||j                                      |¦  «         Œ#t          |                     ¦   «         ¦  «        D ]\  }}t          ||¬¦  «        ||<   Œ|S )zÊ
    Sorts the list of P2P ops by the peer rank, and then calls
    batch_isend_irecv. Return a dictionary of works by peer rank. This function
    helps us avoid hangs in case of skip connections.
    r   ©r<  )r   r¦   ru   Úpeerro   r¥   Úitemsró   )r;  r<  Úops_by_peerÚwork_by_peerr?  rT  Úopss          r?   Ú_sorted_batch_p2prY  ‹  s¥   € õ 0;½4Ñ/@Ô/@€KØ/1€LÝ
ˆ7�|„|�qÒÐØÐð ð (ð (ˆØ�B”GÔ×#Ò# BÑ'Ô'Ð'Ð'õ ˜K×-Ò-Ñ/Ô/Ñ0Ô0ð 8ð 8‰	ˆˆcÝ'¨°$Ð7Ñ7Ô7ˆ�TÑÐàÐrK   Úworkc                 ó8   — | D ]}|                      ¦   «          ŒdS )zX
    Waits for a list of dist.Work (typically from _batch_p2p / _sorted_batch_p2p).
    N)Úwait)rZ  Úws     r?   rò   rò   ¦  s,   € ð ð ð ˆØ	�Š‰Œˆˆðð rK   c                   ó  ‡ — e Zd ZdZ	 	 	 	 	 ddedededz  deedf         dz  d	e	e
ef         dz  d
e	e
ef         ee         z  dz  defˆ fd„Zdd„Zdddddœdedz  dede	e
ef         dz  fd„Zde	eeedz           f         dz  fd„Zˆ xZS )r!   a”  
    Base class for single-stage schedules.
    Implements the `step` method.
    Derived classes should implement `_step_microbatches`.

    Gradients are scaled by num_microbatches depending on the `scale_grads` argument, defaulting to True.  This setting
    should match the configuration of your loss_fn, which may either average losses (scale_grads=True)
    or sum losses (scale_grads=False).
    NTrË   r¶   r·   r¸   .r¹   rº   r»   c                 óÊ   •— t          ¦   «                              ||||||¬¦  «         || _        |j        | _        d| _        d| _        |                      ¦   «         | _        d S )N©r¶   r·   r¸   r¹   rº   r»   F)	ÚsuperrÇ   Ú_stageÚ
num_stagesÚ_num_stagesÚ_stage_forward_initializedÚ_stage_backward_initializedÚ_get_pipeline_orderr€   ©	rV   rË   r¶   r·   r¸   r¹   rº   r»   rÆ   s	           €r?   rÇ   zPipelineScheduleSingle.__init__¹  s{   ø€ õ 	‰Œ×ÒØ)ØØ+Ø/Ø/Ø#ð 	ñ 	
ô 	
ð 	
ð ˆŒØ Ô+ˆÔØ*/ˆÔ'Ø+0ˆÔ(ð ×$Ò$Ñ&Ô&ð 	ÔÐÐrK   c           	      óx   — |                       | j        g|||| j        | j        |¬¦  «        \  | _        | _        d S ©N©rÏ   )r  rb  re  rf  )rV   rù   rú   rû   rÏ   s        r?   Ú_initialize_stagez(PipelineScheduleSingle._initialize_stageÖ  sR   € ð ×&Ò&ØŒ[ˆMØØØØÔ+ØÔ,Ø#ð 'ñ 
ô 
ñ	
ØÔ+ØÔ,Ð,Ð,rK   r   rß   r  rÏ   c                óÆ  — | j         r"t          j        ¦   «         st          d¦  «        ‚| j         | j        _        | j                             ¦   «          |                      ||¦  «        \  }}|�(t          t          |t          | j        ¦  «        ¦  «        nd}	|                      |||	|||¬¦  «         | j        j        r!|r|                      | j        j        ¦  «        S dS ©r"  z’step() requires gradients to be enabled for backward computation; it should not be used under torch.no_grad() context. Please call eval() instead.Nrk  )rÂ   r  Úis_grad_enabledr=   rb  râ   Úclear_runtime_statesr3  r¦   r   Ú_TARGET_CHUNK_SPECr½   r  rÉ   r6  r4  )
rV   rû   rß   r  rÏ   rù   rú   r1  r2  Útargets_splits
             r?   r#  zPipelineScheduleSingle.stepä  s  € ð* Ôð 	¥eÔ&;Ñ&=Ô&=ð 	Ýð.ñô ð ð $(Ô#5ˆŒÔ ð 	Œ×(Ò(Ñ*Ô*Ð*ð $(×#5Ò#5°d¸FÑ#CÔ#CÑ ˆ
�Lð
 Ð!õ •˜vÕ'9¸4Ô;OÑPÔPÑQÔQÐQàð 	ð 	×ÒØØØØØØ#ð 	 ñ 	
ô 	
ð 	
ð Œ;Ôð 	 >ð 	Ø×&Ò& t¤{Ô'@ÑAÔAÐAà�4rK   r9   c                 ó   — dS )a´  
        Returns the pipeline execution order as a schedule IR.

        The returned IR is a dictionary mapping rank IDs to lists of actions.
        Each action is either an _Action object representing computation to perform,
        or None representing a deliberate idle step.

        The None values are used to represent pipeline bubbles where a rank
        must wait for dependencies from other ranks before proceeding. However
        during execution, with  the _PipelineScheduleRuntime, these Nones are
        skipped since the relevant communication (send/recv) will be scheduled and waited on.

        Returns:
            A dictionary mapping rank -> list of actions
        NrJ   rU   s    r?   rg  z*PipelineScheduleSingle._get_pipeline_order   s	   € ð  ˆtrK   r7  ©NN)rA   rB   rC   Ú__doc__r   rt   r   rp   r   r:  rI   r   r|   rÇ   rl  r¦   r#  rM   rg  Ú__classcell__©rÆ   s   @r?   r!   r!   ®  s|  ø€ € € € € ðð ð $(Ø>BØ?CØ@DØ ð
ð 
à!ð
ð ð
ð ˜D‘ð	
ð
 ˜°Ð3Ô4°tÑ;ð
ð    _Ð 4Ô5¸Ñ<ð
ð    S œ>¨E°#¬JÑ6¸Ñ=ð
ð ð
ð 
ð 
ð 
ð 
ð 
ð:
ð 
ð 
ð 
ð" Ø"Ø#Ø-1ð:ð :ð :ð �t‘ð	:ð
 ð:ð ˜#˜s˜(”^ dÑ*ð:ð :ð :ð :ðx T¨#¨t°G¸d±NÔ/CÐ*CÔ%DÀtÑ%Kð ð ð ð ð ð ð ð rK   r!   c                   ón   — e Zd ZdZ	 	 	 	 	 	 ddedz  dedz  dedz  dedz  ded	eeef         dz  fd
„Z	dS )Ú_ScheduleForwardOnlyzo
    The forward-only schedule.
    Will go through all the microbatches and perform only the forward pass
    NTr  r  rÍ   rß   r  rÏ   c                 óT  — |€|�t          d¦  «        ‚|                      ||||¦  «        \  }}|�|d         nd}|                      |d         |d         |¦  «         g }t          | j        ¦  «        D �]}	t          d|	› �¦  «        5  | j                             |	¦  «        }
t          |
d¬¦  «        }| 	                    ¦   «         D ]}t          |¦  «         Œ| j                             |	||	         ||	         ¦  «         | j                             |	¦  «        }
t          |
d¬¦  «        }|                     | 	                    ¦   «         ¦  «         ddd¦  «         n# 1 swxY w Y   t                               d| j        j        |	¦  «         �Œ |D ]}t          |¦  «         ŒdS )	z<
        Run one iteration of the pipeline schedule
        Nz7Forward-only schedule does not support loss computationr   úForward Úfwd_recvrS  Úfwd_sendú[%s] Forwarded microbatch %s)r=   r.  rl  r£   r½   r   rb  Úget_fwd_recv_opsrY  r¤   rò   Úforward_one_chunkÚget_fwd_send_opsrÝ   rÄ   rð   rN   )rV   r  r  rÍ   rß   r  rÏ   Úmaybe_first_targetÚfwd_sends_to_waitrˆ   rX  ÚworksrZ  s                r?   r  z'_ScheduleForwardOnly._step_microbatches9  s
  € ð Ð! VÐ%7ÝØIñô ð ð "×/Ò/°¸ÀJÐPVÑWÔWÑˆ�Ø.8Ð.D˜Z¨œ]˜]È$ÐØ×Ò˜w qœz¨9°Q¬<Ð9KÑLÔLÐLð 46Ðõ �tÔ+Ñ,Ô,ð 	Uñ 	UˆAÝ  ¨A  Ñ0Ô0ð 
9ð 
9Ø”k×2Ò2°1Ñ5Ô5�Ý)¨#°JÐ?Ñ?Ô?�Ø!ŸLšL™NœNð *ð *�DÝ# DÑ)Ô)Ð)Ð)à”×-Ò-¨a°¸´¸YÀq¼\ÑJÔJÐJà”k×2Ò2°1Ñ5Ô5�Ý)¨#°JÐ?Ñ?Ô?�Ø!×(Ò(¨¯ª©¬Ñ8Ô8Ð8ð
9ð 
9ð 
9ñ 
9ô 
9ð 
9ð 
9ð 
9ð 
9ð 
9ð 
9øøøð 
9ð 
9ð 
9ð 
9õ �LŠLÐ7¸¼Ô9PÐRSÑTÔTÐTÑTð
 &ð 	"ð 	"ˆDÝ˜DÑ!Ô!Ð!Ð!ð	"ð 	"s   Â	CE!Å!E%	Å(E%	r8  )
rA   rB   rC   ru  r¦   r|   r:  rI   r   r  rJ   rK   r?   ry  ry  3  s¢   € € € € € ðð ð  $Ø!%Ø"&Ø"Ø#Ø-1ð,"ð ,"à˜‘ð,"ð ˜$‘;ð,"ð ˜4‘Kð	,"ð
 �t‘ð,"ð ð,"ð ˜#˜s˜(”^ dÑ*ð,"ð ,"ð ,"ð ,"ð ,"ð ,"rK   ry  c                   ó¢   — e Zd ZdZ	 	 	 	 	 	 ddedz  dedz  dedz  dedz  ded	eeef         dz  fd
„Z	dee
eedz           f         dz  fd„ZdS )r$   z^
    The GPipe schedule.
    Will go through all the microbatches in a fill-drain manner.
    NTr  r  rÍ   rß   r  rÏ   c           	      óÂ  — |                       ||||¦  «        \  }}|�|d         nd}|                      |d         |d         ||¦  «         g }t          | j        ¦  «        D �]>}	t	          d|	› �¦  «        5  | j                             |	¦  «        }
t          |
d¬¦  «        }|                     ¦   «         D ]}t          |¦  «         Œ| j         
                    |	||	         ||	         |¬¦  «        }| j                             |	¦  «        }
t          |
d¬¦  «        }|                     |                     ¦   «         ¦  «         ddd¦  «         n# 1 swxY w Y   t                               d| j        j        |	¦  «         |                      | j        |||	|¦  «         �Œ@|D ]}t          |¦  «         Œg }t          | j        ¦  «        D �]:}	t	          d	|	› �¦  «        5  | j                             |	¦  «        }
t          |
d
¬¦  «        }|                     ¦   «         D ]}t          |¦  «         Œ|                      | j        |	¦  «        }| j                             |	||	| j        dz
  k    ¬¦  «         | j                             |	¦  «        }
t          |
d¬¦  «        }|                     |                     ¦   «         ¦  «         ddd¦  «         n# 1 swxY w Y   t                               d| j        j        |	¦  «         �Œ<|D ]}t          |¦  «         Œ|                      | j        |¦  «         | j                             | j        r| j        nd¦  «         dS )a6  
        Run one iteration of the pipeline schedule with list of microbatches.
        Will go through all the microbatches according to the GPipe schedule.

        Args:
            microbatches: list of microbatch args.
            return_outputs: whether to return the outputs from the last stage.
        Nr   r{  r|  rS  ©Úsave_forward_outputr}  r~  z	Backward Úbwd_recvr   ©rÐ   Úlast_backwardÚbwd_sendz[%s] Backwarded microbatch %s)r.  rl  r£   r½   r   rb  r  rY  r¤   rò   r€  r�  rÝ   rÄ   rð   rN   rÑ   Úget_bwd_recv_opsrÔ   Úbackward_one_chunkÚget_bwd_send_opsrá   Úperform_reduce_gradr»   )rV   r  r  rÍ   rß   r  rÏ   r‚  rƒ  rˆ   rX  r„  rZ  rÌ   Úbwd_sends_to_waitrÐ   s                   r?   r  z ScheduleGPipe._step_microbatchesn  s
  € ð" "×/Ò/°¸ÀJÐPVÑWÔWÑˆ�Ø.8Ð.D˜Z¨œ]˜]È$ÐØ×ÒØ�AŒJ˜	 !œÐ&8¸+ñ	
ô 	
ð 	
ð
 46Ðõ �tÔ+Ñ,Ô,ð 	Vñ 	VˆAÝ  ¨A  Ñ0Ô0ð 9ð 9Ø”k×2Ò2°1Ñ5Ô5�Ý)¨#°JÐ?Ñ?Ô?�Ø!ŸLšL™NœNð *ð *�DÝ# DÑ)Ô)Ð)Ð)àœ×6Ò6Ø�w˜q”z 9¨Q¤<À^ð 7ñ ô �ð ”k×2Ò2°1Ñ5Ô5�Ý)¨#°JÐ?Ñ?Ô?�Ø!×(Ò(¨¯ª©¬Ñ8Ô8Ð8ð9ð 9ð 9ñ 9ô 9ð 9ð 9ð 9ð 9ð 9ð 9øøøð 9ð 9ð 9ð 9õ �LŠLÐ7¸¼Ô9PÐRSÑTÔTÐTà×$Ò$ T¤[°&¸*ÀaÈÑUÔUÐUÑUð
 &ð 	"ð 	"ˆDÝ˜DÑ!Ô!Ð!Ð!ð 46ÐÝ�tÔ+Ñ,Ô,ð 	Vñ 	VˆAÝ  ¨Q  Ñ1Ô1ð 9ð 9Ø”k×2Ò2°1Ñ5Ô5�Ý)¨#°JÐ?Ñ?Ô?�Ø!ŸLšL™NœNð *ð *�DÝ# DÑ)Ô)Ð)Ð)à×+Ò+¨D¬K¸Ñ;Ô;�Ø”×.Ò.ØØØ"# tÔ';¸aÑ'?Ò"?ð /ñ ô ð ð ”k×2Ò2°1Ñ5Ô5�Ý)¨#°JÐ?Ñ?Ô?�Ø!×(Ò(¨¯ª©¬Ñ8Ô8Ð8ð9ð 9ð 9ñ 9ô 9ð 9ð 9ð 9ð 9ð 9ð 9øøøð 9ð 9ð 9ð 9õ" �LŠLÐ8¸$¼+Ô:QÐSTÑUÔUÐUÑUð &ð 	"ð 	"ˆDÝ˜DÑ!Ô!Ð!Ð!ð 	×Ò˜DœK¨Ñ0Ô0Ð0àŒ×'Ò'ÀÔ@PÐ(W¨Ô(<Ð(<ÐVWÑXÔXÐXÐXÐXs&   Á7CEÅE	ÅE	Ç!C(KËK	ËK	r9   c           	      ó  — i }| j         }t          |¦  «        D ]å}g }|}|                     dg|z  ¦  «         t          | j        ¦  «        D ]0}|                     t          |t          j        |¦  «        ¦  «         Œ1d|dz
  |z
  z  }|                     dg|z  ¦  «         t          | j        ¦  «        D ]0}|                     t          |t          j        |¦  «        ¦  «         Œ1t          || j        ¦  «        ||<   Œæ|S )zš
        Returns the pipeline order for GPipe schedule.

        See base method in PipelineScheduleSingle for details on the schedule IR format.
        Né   r   )
rd  r£   rÝ   r½   ro   rM   r+   rD   rG   Ú_add_reduce_grad)rV   r€   Úpp_group_sizerª   r„   Úwarmup_delayÚmb_idxÚbackward_delays           r?   rg  z!ScheduleGPipe._get_pipeline_orderÂ  s$  € ð ˆØÔ(ˆå˜-Ñ(Ô(ð 	Sð 	SˆDØ,.ˆGð  ˆLØ�NŠN˜D˜6 LÑ0Ñ1Ô1Ð1õ   Ô 4Ñ5Ô5ð Pð P�Ø—’�w tÕ-=Ô-EÀvÑNÔNÑOÔOÐOÐOð  -°!Ñ"3°dÑ":Ñ;ˆNØ�NŠN˜D˜6 NÑ2Ñ3Ô3Ð3õ   Ô 4Ñ5Ô5ð Vð V�Ø—’�w tÕ-=Ô-KÈVÑTÔTÑUÔUÐUÐUå#3°G¸TÔ=QÑ#RÔ#RˆN˜4Ñ Ð àÐrK   r8  )rA   rB   rC   ru  r¦   r|   r:  rI   r   r  rt   rM   rg  rJ   rK   r?   r$   r$   h  sì   € € € € € ðð ð  $Ø!%Ø"&Ø"Ø#Ø-1ðRYð RYà˜‘ðRYð ˜$‘;ðRYð ˜4‘Kð	RYð
 �t‘ðRYð ðRYð ˜#˜s˜(”^ dÑ*ðRYð RYð RYð RYðh T¨#¨t°G¸d±NÔ/CÐ*CÔ%DÀtÑ%Kð ð ð ð ð ð rK   r$   c                   ó6  ‡ — e Zd ZdZ	 	 	 	 	 ddedededz  deedf         dz  d	e	e
ef         dz  d
e	e
ef         ee         z  dz  defˆ fd„Z	 	 	 	 	 	 ddedz  dedz  dedz  dedz  dede	e
ef         dz  fd„Zde	eeedz           f         dz  fd„Zˆ xZS )r#   zo
    The 1F1B schedule.
    Will perform one forward and one backward on the microbatches in steady state.
    NTrË   r¶   r·   r¸   .r¹   rº   r»   c           	      ó¤   •— t          ¦   «                              |||||||¬¦  «         || j        k     rt          d|› d| j        › d�¦  «        ‚d S )N)rË   r¶   r·   r¸   r¹   rº   r»   zNumber of microbatches (z9) must be greater than or equal to the number of stages (z).)ra  rÇ   rd  r<   rh  s	           €r?   rÇ   zSchedule1F1B.__init__é  s‹   ø€ õ 	‰Œ×ÒØØ)ØØ+Ø/Ø/Ø#ð 	ñ 	
ô 	
ð 	
ð ˜DÔ,Ò,Ð,Ýð8¨>ð 8ð 8Ø#'Ô#3ð8ð 8ð 8ñô ð ð -Ð,rK   r  r  rÍ   rß   r  rÏ   c                 ó´  — |                       ||||¦  «        \  }}|�|d         nd}|                      |d         |d         ||¦  «         t          | j        | j        | j        j        z
  ¦  «        }d}	d}
g }g }t          |¦  «        D ]Ê}| j                             |	¦  «        }t          t          |d¬¦  «        ¦  «         | j                             |	||	         ||	         |¬¦  «        }t          |¦  «         | j                             |	¦  «        }|	|dz
  k    rt          |d¬¦  «        }|                      | j        |||	|¦  «         |	dz  }	ŒË	 | j                             |
¦  «        }t          t          ||z   d	¬¦  «        ¦  «         |                      | j        |
¦  «        }| j                             |
||
| j        dz
  k    ¬
¦  «         | j                             |
¦  «        }|
dz  }
|	| j        k    rn¤| j                             |	¦  «        }t          t          ||z   d¬¦  «        ¦  «         | j                             |	||	         ||	         |¬¦  «        }|                      | j        |||	|¦  «         | j                             |	¦  «        }|	dz  }	�ŒNt          |d¬¦  «        }|
| j        k     rÆ| j                             |
¦  «        }t          t          |d¬¦  «        ¦  «         |                      | j        |
¦  «        }| j                             |
||
| j        dz
  k    ¬
¦  «         t          |¦  «         | j                             |
¦  «        }t          |d¬¦  «        }|
dz  }
|
| j        k     °Æt          |¦  «         |                      | j        |¦  «         | j                             | j        r| j        nd¦  «         dS )a†  
        Run one iteration of the pipeline schedule with list of microbatches.
        Will go through all the microbatches according to the 1F1B schedule.

        Args:
            microbatches: list of microbatch args.
            return_outputs: whether to return the outputs from the last stage.
            loss_kwargs: extra keyword arguments forwarded to the loss function.
        Nr   r|  rS  r‡  r   r}  TÚfwd_send_bwd_recvrŠ  Úbwd_send_fwd_recvrŒ  r‰  )r.  rl  Úminr½   rd  rb  rN   r£   r  rò   ró   r€  r�  rÑ   r�  rÔ   rŽ  r�  rá   r�  r»   )rV   r  r  rÍ   rß   r  rÏ   r‚  Úwarmup_chunksÚfwd_mb_indexÚbwd_mb_indexÚ	send_workÚ	fwd_sendsÚ_Ú	fwd_recvsrÌ   Ú	bwd_recvsrÐ   Ú	bwd_sendss                      r?   r  zSchedule1F1B._step_microbatches  s^  € ð$ "×/Ò/°¸ÀJÐPVÑWÔWÑˆ�Ø.8Ð.D˜Z¨œ]˜]È$ÐØ×ÒØ�AŒJ˜	 !œÐ&8¸+ñ	
ô 	
ð 	
õ ØÔ ØÔ˜tœ{Ô6Ñ6ñ
ô 
ˆð ˆØˆð &(ˆ	Øˆ	Ý�}Ñ%Ô%ð 	ð 	ˆAàœ×4Ò4°\ÑBÔBˆIÝ�J y°zÐBÑBÔBÑCÔCÐCð ”[×2Ò2ØØ˜Ô%Ø˜,Ô'Ø$2ð	 3ñ ô ˆFõ ˜IÑ&Ô&Ð&ð œ×4Ò4°\ÑBÔBˆIØ˜}¨qÑ0Ò0Ð0å& y°zÐBÑBÔB�	ð
 ×$Ò$Ø”˜V Z°¸{ñô ð ð ˜AÑˆLˆLð
,	àœ×4Ò4°\ÑBÔBˆIõ �J y°9Ñ'<ÐCVÐWÑWÔWÑXÔXÐXð ×'Ò'¨¬°\ÑBÔBˆDØŒK×*Ò*ØØØ*¨dÔ.BÀQÑ.FÒFð +ñ ô ð ð œ×4Ò4°\ÑBÔBˆIØ˜AÑˆLà˜tÔ3Ò3Ð3àð œ×4Ò4°\ÑBÔBˆIõ �J y°9Ñ'<ÐCVÐWÑWÔWÑXÔXÐXð ”[×2Ò2ØØ˜Ô%Ø˜,Ô'Ø$2ð	 3ñ ô ˆFð ×$Ò$Ø”˜V Z°¸{ñô ð ð
 œ×4Ò4°\ÑBÔBˆIØ˜AÑˆLñY,	õ^ ˜y¨zÐ:Ñ:Ô:ˆ	ð ˜TÔ1Ò1Ð1àœ×4Ò4°\ÑBÔBˆIÝ�J y°zÐBÑBÔBÑCÔCÐCð ×'Ò'¨¬°\ÑBÔBˆDØŒK×*Ò*ØØØ*¨dÔ.BÀQÑ.FÒFð +ñ ô ð õ ˜IÑ&Ô&Ð&ð œ×4Ò4°\ÑBÔBˆIÝ" 9°:Ð>Ñ>Ô>ˆIØ˜AÑˆLð' ˜TÔ1Ò1Ð1õ, 	˜	Ñ"Ô"Ð"ð 	×Ò˜DœK¨Ñ0Ô0Ð0àŒ×'Ò'ÀÔ@PÐ(W¨Ô(<Ð(<ÐVWÑXÔXÐXÐXÐXrK   r9   c           	      óþ  — i }| j         }t          |¦  «        D �]â}g }|                     dg|z  ¦  «         |dz
  |z
  }d}t          |¦  «        D ]2}|                     t	          |t
          j        |¦  «        ¦  «         |}Œ3t          dd|dz
  |z
  z  ¦  «        }|                     dg|z  ¦  «         d}	| j        |z
  }
|
dk    rq|dz  }|                     t	          |t
          j        |¦  «        ¦  «         |
dz  }
|                     t	          |t
          j	        |	¦  «        ¦  «         |	dz  }	|
dk    °q| j        |	z
  }|dk    r›||z
  dk    rT|                     d¦  «         |dk    r8|                     t	          |t
          j	        |	¦  «        ¦  «         |	dz  }	|dz  }n8|                     t	          |t
          j	        |	¦  «        ¦  «         |	dz  }	|dz  }|dk    °›t          || j        ¦  «        ||<   �Œä|S )z™
        Returns the pipeline order for 1F1B schedule.

        See base method in PipelineScheduleSingle for details on the schedule IR format.
        Nr   r   r–   )rd  r£   rÝ   ro   rM   r+   rD   r“   r½   rG   r”  )rV   r€   r•  rª   r„   Únum_forwardÚ
forward_mbrˆ   Úwait_for_1f1bÚbackward_mbÚremaining_forwardÚremaining_backwards               r?   rg  z Schedule1F1B._get_pipeline_order›  sn  € ð ˆØÔ(ˆå˜-Ñ(Ô(ð 8	Sñ 8	SˆDØ,.ˆGð �NŠN˜D˜6 D™=Ñ)Ô)Ð)ð )¨1Ñ,°Ñ4ˆKØˆJÝ˜;Ñ'Ô'ð ð �Ø—’�w tÕ-=Ô-EÀqÑIÔIÑJÔJÐJØ�
�
õ    1¨¸Ñ(9¸DÑ(@Ñ#AÑBÔBˆMØ�NŠN˜D˜6 MÑ1Ñ2Ô2Ð2ð ˆKØ $Ô 4°{Ñ BÐà# aÒ'Ð'à˜a‘�
Ø—’�w tÕ-=Ô-EÀzÑRÔRÑSÔSÐSØ! QÑ&Ð!ð —’Ý˜DÕ"2Ô"@À+ÑNÔNñô ð ð ˜qÑ �ð $ aÒ'Ð'ð "&Ô!5¸Ñ!CÐà$ qÒ(Ð(ð " DÑ(¨AÒ-Ð-Ø—N’N 4Ñ(Ô(Ð(à)¨AÒ-Ð-ØŸšÝ# DÕ*:Ô*HÈ+ÑVÔVñô ð ð $ qÑ(˜Ø*¨aÑ/Ð*øð —N’NÝ Õ&6Ô&DÀkÑRÔRñô ð ð   1Ñ$�KØ&¨!Ñ+Ð&ð% % qÒ(Ð(õ( $4°G¸TÔ=QÑ#RÔ#RˆN˜4Ñ Ñ ØÐrK   r7  r8  )rA   rB   rC   ru  r   rt   r   rp   r   r:  rI   r   r|   rÇ   r¦   r  rM   rg  rv  rw  s   @r?   r#   r#   ã  s°  ø€ € € € € ðð ð $(Ø>BØ?CØ@DØ ðð à!ðð ðð ˜D‘ð	ð
 ˜°Ð3Ô4°tÑ;ðð    _Ð 4Ô5¸Ñ<ðð    S œ>¨E°#¬JÑ6¸Ñ=ðð ðð ð ð ð ð ð6  $Ø!%Ø"&Ø"Ø#Ø-1ðWYð WYà˜‘ðWYð ˜$‘;ðWYð ˜4‘Kð	WYð
 �t‘ðWYð ðWYð ˜#˜s˜(”^ dÑ*ðWYð WYð WYð WYðrB T¨#¨t°G¸d±NÔ/CÐ*CÔ%DÀtÑ%Kð Bð Bð Bð Bð Bð Bð Bð BrK   r#   Úaction_typec                 ó"   — | t           t          fv S rS   )r.   r5   )r¯  s    r?   Ú_requires_reduce_gradr±  à  s   € Ø�1�a˜&Ð Ð rK   r„   r¶   c           	      óP  ‡‡— g }t          t          ¦  «        Šˆˆfd„}| D ]„}|€Œ|                     |¦  «         g }|j        t          k    r|j        �|j        D ]} |||¦  «         Œn |||¦  «         |D ]+}|                     t          |t          d¦  «        ¦  «         Œ,Œ…|S )z«
    REDUCE_GRAD refers to joint across minibatches grad reduction.
    reduce_grad frees memory and we want to schedule it just after the last "backward"-like stage.
    c                 ó¨   •— t          | j        ¦  «        r:| j        }‰|xx         dz  cc<   ‰|         ‰k    r|                     |¦  «         d S d S d S ©Nr   )r±  rO   rN   ro   )ÚaÚto_schedulerN   Úcntr¶   s      €€r?   Ú_leaf_actionz&_add_reduce_grad.<locals>._leaf_actionî  su   ø€ Ý  Ô!3Ñ4Ô4ð 	0Øœ-ˆKØ�ÐÐÔ Ñ!ÐÐÑØ�;Ô >Ò1Ð1Ø×"Ò" ;Ñ/Ô/Ð/Ð/Ð/ð		0ð 	0ð 2Ð1rK   N)r   rt   ro   rO   r6   rQ   rM   r7   )	r„   r¶   Úactions_with_reduce_gradr¸  rµ  Úschedule_reduce_grad_stage_idxsr\   Ú	stage_idxr·  s	    `      @r?   r”  r”  ä  s  øø€ ð 68ÐÝ%¥cÑ*Ô*€Cð0ð 0ð 0ð 0ð 0ð 0ð ð Sð SˆØˆ9ØØ ×'Ò'¨Ñ*Ô*Ð*Ø57Ð'ØÔ¥Ò,Ð,°´Ð1JØœmð Jð J�
Ø�˜ZÐ)HÑIÔIÐIÐIðJð ˆL˜Ð;Ñ<Ô<Ð<à8ð 	Sð 	SˆIØ$×+Ò+­G°I½{ÈDÑ,QÔ,QÑRÔRÐRÐRð	Sà#Ð#rK   r“  Úcompute_actionsÚmax_active_stagesc                 óD  ‡
‡‡— dt           dt          t          dz           dt          t                    fd„}t          ¦   «         Š
g Šdt           fˆ
ˆfd„}dt           fˆ
ˆfd„}t	          | ¦  «        D ]‘\  }}|€Œ ||| |d…         ¦  «        Št          t          ˆ
fd	„‰¦  «        ¦  «        }t          t          ˆfd
„‰
¦  «        ¦  «        }|D ]}	 ||	¦  «         Œ|D ]}	 ||	¦  «         Œ‰                     |¦  «         Œ’t          ‰
¦  «        D ]}	 ||	¦  «         Œ‰S )a]  Given a basic schedule involving only compute actions (F,B,W,OVERLAP_F_B), add UNSHARD/RESHARD actions for FSDP.

    UNSHARD refers to fetching the full contents of an FSDP-sharded layer, requiring an all-gather operation.
    RESHARD does the opposite, releasing memory (but doing no communication)

    We abandon the "timestep lock"  during lowering

    max_active_stages controls how many prefetches we allow. It should be measured in mb and tuneable but in practice
    3 stages is probably the thing we want?
    (to account for having one f and one b active, and something else prefetching?)
    ÚcountÚnext_actionsNr9   c                 óÀ  — t          ¦   «         }g }|D ]Ê}|�Æ|j        t          k    rd|j        �]|j        D ]?}|j        |vr4|                     |j        ¦  «         |                     |j        ¦  «         Œ@t          |¦  «        | k    r nTŒx|j        |vrI|                     |j        ¦  «         |                     |j        ¦  «         t          |¦  «        | k    r nŒË|S )zdRemove duplicates (same stage, different microbatch), find next 'count' stages that will do compute.)ÚsetrO   r6   rQ   rN   Úaddro   ru   )r¿  rÀ  ÚseenÚretrµ  r\   s         r?   Únext_stage_indicesz0_add_unshard_reshard.<locals>.next_stage_indices  sñ   € å™œˆØˆàð 	"ð 	"ˆAØˆ}àÔ%­Ò4Ð4¸¼Ð9RØ&'¤mð ?ð ?˜
Ø%Ô1¸Ð=Ð=Ø ŸHšH ZÔ%;Ñ<Ô<Ð<ØŸJšJ zÔ'=Ñ>Ô>Ð>øÝ˜3‘x”x 5Ò(Ð(Ø˜ð )ð ”}¨DÐ0Ð0ØŸš ¤Ñ/Ô/Ð/ØŸ
š
 1¤=Ñ1Ô1Ð1Ý˜s™8œ8 uÒ,Ð,Ø!˜EøØˆ
rK   rN   c                 ó„   •— ‰                      | ¦  «         ‰                     t          | t          d ¦  «        ¦  «         d S rS   )rÃ  ro   rM   r/   ©rN   Úactive_stagesÚfsdp_aware_actionss    €€r?   Ú_unshardz&_add_unshard_reshard.<locals>._unshard0  s=   ø€ Ø×Ò˜+Ñ&Ô&Ð&Ø×!Ò!¥'¨+µwÀÑ"EÔ"EÑFÔFÐFÐFÐFrK   c                 ó„   •— ‰                      | ¦  «         ‰                     t          | t          d ¦  «        ¦  «         d S rS   )Úremovero   rM   r0   rÈ  s    €€r?   Ú_reshardz&_add_unshard_reshard.<locals>._reshard4  s=   ø€ Ø×Ò˜[Ñ)Ô)Ð)Ø×!Ò!¥'¨+µwÀÑ"EÔ"EÑFÔFÐFÐFÐFrK   c                 ó   •— | ‰vS rS   rJ   )ÚsrÉ  s    €r?   ú<lambda>z&_add_unshard_reshard.<locals>.<lambda>?  s   ø€  a¨}Ð&<€ rK   c                 ó   •— | ‰vS rS   rJ   )rÐ  Únext_ns    €r?   rÑ  z&_add_unshard_reshard.<locals>.<lambda>A  s   ø€  a¨v o€ rK   )rt   r¦   rM   rÂ  rž   Úfilterro   )r¼  r½  rÆ  rË  rÎ  rˆ   r8   ÚfetchÚevictrË   rÉ  rÊ  rÓ  s             @@@r?   Ú_add_unshard_reshardr×    s¹  øøø€ ð ¥#ð µT½'ÀD¹.Ô5Ið ÍdÕSVÌið ð ð ð õ0 "™eœe€MØ(*ÐðG�cð Gð Gð Gð Gð Gð Gð GðG�cð Gð Gð Gð Gð Gð Gð Gõ ˜Ñ/Ô/ð *ð *‰	ˆˆ6Øˆ>Øð $Ð#Ð$5°ÀqÀrÀrÔ7JÑKÔKˆå•VÐ<Ð<Ð<Ð<¸fÑEÔEÑFÔFˆå•VÐ5Ð5Ð5Ð5°}ÑEÔEÑFÔFˆð ð 	ð 	ˆEØˆH�U‰OŒOˆOˆOØð 	ð 	ˆEØˆH�U‰OŒOˆOˆOØ×!Ò! &Ñ)Ô)Ð)Ð)õ �mÑ$Ô$ð ð ˆØˆ�‰ŒˆˆàÐrK   c                 óF  — g }| �r|                       d¦  «        }|€Œt          | ¦  «        r4| d         €,|                       d¦  «         t          | ¦  «        r| d         ®,t          | ¦  «        dk    r| d         nd}|j        t          k    r{|�y|j        t          k    ri|j        |j        k    rY|j        |j        k    rI|                     t          |j        t          |j        ¦  «        ¦  «         |                       d¦  «         n|                     |¦  «         | �°|S )a9  Given a basic schedule involving only compute actions (F,I,W), merge adjacent I and W ops into B ops.
    (note: I = BACKWARD_INPUT, W = BACKWARD_WEIGHT, B = FULL_BACKWARD)

    B refers to running the whole backward (not separating grad_input and grad_weight), which can be more efficient
    in some cases.
    r   N)
Úpopru   rO   rE   rF   rN   rP   ro   rM   rG   )r¼  Úmerged_actionsr8   Únext_actions       r?   Ú	_merge_bwrÜ  X  sM  € ð €NØ
ñ *Ø ×$Ò$ QÑ'Ô'ˆØˆ>Øõ �/Ñ"Ô"ð 	# °qÔ'9Ð'AØ×Ò Ñ"Ô"Ð"õ �/Ñ"Ô"ð 	# °qÔ'9Ð'Aõ -0°Ñ,@Ô,@À1Ò,DÐ,D�o aÔ(Ð(È$ˆð Ô#¥~Ò5Ð5ØÐ'ØÔ,µÒ?Ð?ØÔ" kÔ&=Ò=Ð=ØÔ'¨;Ô+GÒGÐGà×!Ò!Ý˜Ô*­M¸6Ô;RÑSÔSñô ð ð ×Ò Ñ"Ô"Ð"Ð"à×!Ò! &Ñ)Ô)Ð)ð1 ñ *ð2 ÐrK   Ústage_to_rankrc  c           
      ó”  ‡‡‡‡‡‡— d„ | D ¦   «         }d„ | D ¦   «         Šdt           dt          fˆˆfd„Šdt           dt          t           t           f         fˆfd„}dt           dz  dt          t                    dt          fˆfd	„Š| �rÂd
}t	          | ¦  «        D �]›Št          | ‰         ¦  «        dk    s(t          d‰›dt          | ‰         ¦  «        ›�¦  «        ‚| ‰         d         }|�|j        �|j        }n|f}t          ˆˆˆfd„|D ¦   «         ¦  «        sŒ„|�Ü|‰          	                    |¦  «         |D ]¾}‰‰          
                    |¦  «          ‰|¦  «        r– ||¦  «        \  }	}
|‰          	                    |	¦  «         ‰‰          
                    |	¦  «         | ‰|
j        ¦  «                  	                    |
¦  «         ‰ ‰|
j        ¦  «                  
                    |
¦  «         Œ¿| ‰                              d¦  «         t          | ‰         ¦  «        dk    r| ‰= d}�Œ�|st          d¦  «        ‚| �°Â|S )zé
    Transforms a compute-only schedule into a complete schedule with communication actions.

    For actions with sub-actions (OVERLAP_F_B) we ensure that all the subactions have been
    computed and the communication is ready
    c                 ó   — i | ]}|g “ŒS rJ   rJ   ©r[   rª   s     r?   ú
<dictcomp>z"_add_send_recv.<locals>.<dictcomp>‰  s   € Ð-SÐ-SÐ-S¸4¨d°BÐ-SÐ-SÐ-SrK   c                 ó,   — i | ]}|t          ¦   «         “ŒS rJ   ©rÂ  rà  s     r?   rá  z"_add_send_recv.<locals>.<dictcomp>Š  s   € Ð,UÐ,UÐ,U¸T¨Tµ3±5´5Ð,UÐ,UÐ,UrK   r8   r9   c                 ó  •— | j         t          k    r3| j        ‰dz
  k    o$ ‰| j        dz   ¦  «         ‰| j        ¦  «        k    S | j         t          t          fv r0| j        dk    o$ ‰| j        dz
  ¦  «         ‰| j        ¦  «        k    S dS )Nr   r   F)rO   r,   rN   rE   rG   )r8   rc  rÝ  s    €€r?   Ú
_has_commsz"_add_send_recv.<locals>._has_commsŒ  s·   ø€ ØÔ"¥aÒ'Ð'ØÔ%¨°a©Ò7ð 3¸M¸MØÔ" QÑ&ñ=ô =à�˜vÔ1Ñ2Ô2ò=3ð 3ð Ô$­½Ð(GÐGÐGØÔ%¨Ò*ð 3¨}¨}ØÔ" QÑ&ñ0ô 0à�˜vÔ1Ñ2Ô2ò03ð 3ð ˆurK   c                 ó:  •—  ‰| ¦  «        st          | › d�¦  «        ‚| j        }| j        }| j        }t	          ||t
          k    rt          nt          |¦  «        }|t
          k    r|dz   n|dz
  }t	          ||t
          k    rt          nt          |¦  «        }||fS )Nz is not a valid comm actionr   )
r  rN   rO   rP   rM   r,   r1   r3   r2   r4   )r8   r»  Úctyper—  ÚsendÚrecv_stage_idxÚrecvrå  s          €r?   Ú
_get_commsz"_add_send_recv.<locals>._get_comms—  s¢   ø€ Øˆz˜&Ñ!Ô!ð 	IÝ  FÐ!GÐ!GÐ!GÑHÔHÐHØÔ&ˆ	ØÔ'ˆØÔ(ˆÝ�y¨EµQªJ¨J¥& &½FÀFÑKÔKˆØ*/µ1ª*¨*˜ Q™˜¸)Àa¹-ˆÝ�~°½!²°¥v vÅÈÑPÔPˆØ�TˆzÐrK   NÚprev_actionsc                 ó  •— | €dS | j         t          k    rX| j        dk    rMt          | j        t          | j        ¦  «        |v rdS t          | j        dz
  t          | j        ¦  «        |v rdS dS | j         t          t          fv r‚| j        ‰dz
  k    rtt          | j        t          | j        ¦  «        |v rdS t          | j        dz   t          | j        ¦  «        |v rdS t          | j        dz   t          | j        ¦  «        |v rdS dS dS )a  We don't put our own recv ops in the schedule, we let a sender on another rank put our recv ops in place.
        This helps ensure a sane (non-hanging) ordering of sends and recvs.
        But it also means we might not be able to schedule our next compute action yet.
        NTr   r   F)	rO   r,   rN   rM   r2   rP   rE   rG   r4   )r8   rì  rc  s     €r?   Ú_ready_to_schedulez*_add_send_recv.<locals>._ready_to_schedule¢  s<  ø€ ð
 ˆ>Ø�4ØÔ$­Ò)Ð)¨fÔ.@ÀAÒ.EÐ.Eå˜Ô*­F°FÔ4KÑLÔLØð ð  ð �tå˜Ô*¨QÑ.µ°6Ô3JÑKÔKØð ð  ð �tØ�5àÔ#­½Ð'FÐFÐFØÔ" j°1¡nÒ4Ð4õ ˜Ô*­F°FÔ4KÑLÔLØð ð  ð �tå˜Ô*¨QÑ.µÀÔ@WÑXÔXØð ð  ð �tå˜Ô*¨QÑ.µ¸vÔ?VÑWÔWØð ð  ð �tØ�5à�4rK   Fr   úrank=z, len(compute_actions[rank])=c              3   ó<   •K  — | ]} ‰|‰‰         ¦  «        V — Œd S rS   rJ   )r[   rµ  rî  rì  rª   s     €€€r?   r…   z!_add_send_recv.<locals>.<genexpr>Ù  s6   øè è € ÐVÐVÀQÐ)Ð)¨!¨\¸$Ô-?Ñ@Ô@ÐVÐVÐVÐVÐVÐVrK   Tz6Malformed compute schedule, can't schedule sends/recvs)rM   r|   rp   rÂ  r¥   ru   r  rQ   ré   ro   rÃ  rN   rÙ  )r¼  rÝ  rc  Úcomm_actionsrë  Úprogressr8   Úall_actionsrµ  rè  rê  rå  rî  rì  rª   s    ``        @@@@r?   Ú_add_send_recvrô  ~  sú  øøøøøø€ ð .TÐ-SÀ?Ð-SÑ-SÔ-S€LØ,UÐ,UÀ_Ð,UÑ,UÔ,U€Lð	�7ð 	¥tð 	ð 	ð 	ð 	ð 	ð 	ð 	ð	�7ð 	¥u­WµgÐ-=Ô'>ð 	ð 	ð 	ð 	ð 	ð 	ð(¥7¨T¡>ð (ÅÅWÄð (ÕRVð (ð (ð (ð (ð (ð (ðT ñ %Øˆå˜?Ñ+Ô+ð 	ñ 	ˆDÝ˜¨Ô-Ñ.Ô.°Ò2Ð2Ý$Ð%N¨Ð%NÐ%Nµ°_ÀTÔ5JÑ1KÔ1KÐ%NÐ%NÑOÔOÐOØ$ TÔ*¨1Ô-ˆFàÐ! fÔ&8Ð&DØ$Ô0��à%˜i�åÐVÐVÐVÐVÐVÐVÈ+ÐVÑVÔVÑVÔVð Øð Ð!Ø˜TÔ"×)Ò)¨&Ñ1Ô1Ð1Ø$ð 	Pð 	P�AØ  Ô&×*Ò*¨1Ñ-Ô-Ð-Ø!�z !‘}”}ð PØ%/ Z°¡]¤]™
˜˜dð % TÔ*×1Ò1°$Ñ7Ô7Ð7Ø$ TÔ*×.Ò.¨tÑ4Ô4Ð4Ø$ ] ]°4Ô3CÑ%DÔ%DÔE×LÒLÈTÑRÔRÐRØ$ ] ]°4Ô3CÑ%DÔ%DÔE×IÒIÈ$ÑOÔOÐOøà˜DÔ!×%Ò% aÑ(Ô(Ð(Ý�? 4Ô(Ñ)Ô)¨QÒ.Ð.Ø# DÐ)ØˆH‰HØð 	Ý ØHñô ð ðG ñ %ðL ÐrK   c           
      ó:  ‡‡‡‡‡— t           j        Št           j        }t           j        Št           j        }dt
          dt          fˆˆfd„Šdt
          dt          fˆˆfd„}i }|                      ¦   «         D �]£\  }}g }i }	|D �]Y}
|
j        ‰|fv r|
j	        |
j        |
j
        f}|
|	|<   Œ(|
j        ‰|fv r_ ||
¦  «        Š|‰k     rNˆˆfd„|	                     ¦   «         D ¦   «         }|D ]*}|                     |	                     |¦  «        ¦  «         Œ+|
j        �|
j        n|
f}|D ]ž}|j        t          k    r<|j	        ‰|j
        f}||	v r(|                     |	                     |¦  «        ¦  «         ŒN|j        t          t           fv r;|j	        ||j
        f}||	v r(|                     |	                     |¦  «        ¦  «         ŒŸ|                     |
¦  «         �Œ[|	r5t#          d|› dt%          |	                     ¦   «         ¦  «        › d	�¦  «        ‚|||<   �Œ¥|S )
aŸ  
    Defers RECV operations to reduce interference with unrelated compute ops,
    while maintaining deadlock-safe ordering via rank-parity P2P ordering.

    By default, the schedule places RECV ops as early as possible (ASAP) to overlap
    P2P communication with computation. However, on some platforms (e.g., AMD ROCm),
    a pending RECV can block unrelated compute ops that also use the communication
    fabric (e.g., FSDP allgather inside a forward pass), creating pipeline bubbles.

    This function defers each RECV to as late as possible, subject to:
      1. A RECV must appear before the compute op that consumes its data.
      2. Deadlock avoidance via rank-parity ordering (see pytorch/pytorch#172668):
         - When current rank > peer rank: SEND before RECV is safe, so deferred
           RECVs from that peer are NOT flushed before SENDs to that peer.
         - When current rank < peer rank: RECV before SEND is required, so
           deferred RECVs from that peer ARE flushed before SENDs to that peer.

    This breaks circular waits: the lower-ranked side always posts RECV first,
    providing the matching target for the higher-ranked side's SEND.
    r8   r9   c                 óf   •— | j         ‰k    r ‰| j        dz
  ¦  «        S  ‰| j        dz   ¦  «        S r´  ©rO   rN   )r8   r2   rÝ  s    €€r?   Ú_recv_peer_rankz(_defer_recv_ops.<locals>._recv_peer_rank  óA   ø€ ØÔ" fÒ,Ð,Ø �= Ô!3°aÑ!7Ñ8Ô8Ð8à �= Ô!3°aÑ!7Ñ8Ô8Ð8rK   c                 óf   •— | j         ‰k    r ‰| j        dz   ¦  «        S  ‰| j        dz
  ¦  «        S r´  r÷  )r8   r1   rÝ  s    €€r?   Ú_send_peer_rankz(_defer_recv_ops.<locals>._send_peer_rank  rù  rK   c                 ó8   •— g | ]\  }} ‰|¦  «        ‰k    ¯|‘ŒS rJ   rJ   )r[   ÚkÚvrø  rT  s      €€r?   r]   z#_defer_recv_ops.<locals>.<listcomp>2  s9   ø€ ð  ð  ð  Ù"˜a ¸/¸/È!Ñ:LÔ:LÐPTÒ:TÐ:T˜Ð:TÐ:TÐ:TrK   Nz!Malformed input schedule on rank z,: leftover RECV ops with no consumer found: z9. Every RECV must be consumed by a downstream compute op.)r+   r2   r4   r1   r3   rM   rt   rU  rO   rN   rP   ro   rÙ  rQ   rD   rG   rE   r  r¦   r¤   )r„   rÝ  r4   r3   rû  rõ   rª   Úaction_listÚnew_actionsÚdeferredr8   rŒ   Úto_flushÚ	consumersÚsubr2   r1   rø  rT  s    `             @@@@r?   Ú_defer_recv_opsr  õ  sÛ  øøøøø€ õ0 Ô$€FÝÔ$€FÝÔ$€FÝÔ$€Fð9¥ð 9­Cð 9ð 9ð 9ð 9ð 9ð 9ð 9ð9¥ð 9­Cð 9ð 9ð 9ð 9ð 9ð 9ð 9ð (*€FØ$Ÿ]š]™_œ_ð 0#ñ 0#ÑˆˆkØ%'ˆØLNˆà!ð #	'ñ #	'ˆFØÔ&¨6°6Ð*:Ð:Ð:àÔ&ØÔ+ØÔ+ð�ð
 !'�˜‘ØàÔ&¨6°6Ð*:Ð:Ð:Ø&� vÑ.Ô.�ð ˜$’;�;ð ð  ð  ð  ð  Ø&.§n¢nÑ&6Ô&6ð ñ  ô  �Hð  (ð >ð >˜Ø#×*Ò*¨8¯<ª<¸Ñ+<Ô+<Ñ=Ô=Ð=Ð=ð '-Ô&8Ð&D�Ô"Ð"È6È)ð ð !ð >ð >�ØÔ'­7Ò2Ð2Øœ?¨F°CÔ4HÐI�CØ˜h��Ø#×*Ò*¨8¯<ª<¸Ñ+<Ô+<Ñ=Ô=Ð=øØÔ)­m½^Ð-LÐLÐLØœ?¨F°CÔ4HÐI�CØ˜h��Ø#×*Ò*¨8¯<ª<¸Ñ+<Ô+<Ñ=Ô=Ð=øà×Ò˜vÑ&Ô&Ð&Ñ&àð 	Ý ðJ°Dð Jð JÝ+/°·²Ñ0AÔ0AÑ+BÔ+BðJð Jð Jñô ð ð #ˆˆt‰‰Ø€MrK   r•  Únum_microbatchesc                 ó  ‡ ‡‡— t          ‰ ¦  «        |k    s"t          d|› dt          ‰ ¦  «        › �¦  «        ‚t          |¦  «        D ]}|‰ vrt          d|› �¦  «        ‚Œd„ t          |¦  «        D ¦   «         Ši Šdt          dt          dt          fˆ ˆˆfd„}‰ D ]z}t          ‰ |         ¦  «        D ]b\  }}|€Œt          |t          ¦  «        st          d	|› d
|› d|› d�¦  «        ‚|j        �|j        D ]} ||||¦  «         ŒŒU ||||¦  «         ŒcŒ{‰D ]ó}	t          ‰|	         t                   ¦  «        }
t          ‰|	         t                   ¦  «        }t          ‰|	         t                   ¦  «        }t          ‰|	         t                   ¦  «        }|
|k    s t          d|
› dt          › d|	› d|› �¦  «        ‚||k    st          d|	› d|› d|› �¦  «        ‚|||z   dz  z   |k    st          d|	› d|› d|› d|› d|› �
¦  «        ‚Œô‰S )Nz2Schedule has incorrect number of ranks - expected z	, actual z%Schedule is missing actions for rank c                 ó¬   — i | ]Q}|t           t          ¦   «         t          t          ¦   «         t          t          ¦   «         t          t          ¦   «         i“ŒRS rJ   )r,   rÂ  r5   r-   r.   )r[   Ústage_ids     r?   rá  z&_validate_schedule.<locals>.<dictcomp>c  sS   € ð =ð =ð =ð ð 	Ý�s‰uŒuÝ�s‰uŒuÝ�s‰uŒuÝ�s‰uŒuð	
ð=ð =ð =rK   r8   rª   r#  c                 óò  •— | j         }| j        }| j        }|t          k    r(‰|         t                                        |¦  «         �nv|t
          k    rr|‰|         t                   vr6d|› d|› d|› d|› d�	}t          ‰
|¬¦  «        }|› d|› �}t          |¦  «        ‚‰|         t
                                        |¦  «         nù|t          k    rr|‰|         t                   vr6d|› d|› d|› d|› d�	}t          ‰
|¬¦  «        }|› d|› �}t          |¦  «        ‚‰|         t                                        |¦  «         n||t          k    rq|‰|         t                   vr6d|› d|› d	|› d|› d
�	}t          ‰
|¬¦  «        }|› d|› �}t          |¦  «        ‚‰|         t                                        |¦  «         |‰vr|‰|<   dS ‰|         }	||	k    st          d|› d|› d|› d|› d|	› �
¦  «        ‚dS )zPProcess a single action and update stage_actions and stage_index_to_rank_mappingr�   ú, step z": Running Full Backward for stage z, microbatch z without first running Forward©r�   z

Full pipeline schedule:
z#: Running Backward Input for stage z$: Running Backward Weight for stage z% without first running Backward Inputz: Stage z is assigned to both rank z
 and rank N)
rN   rO   rP   r,   rÃ  r5   r³   r  r-   r.   )r8   rª   r#  Ús_idrç  Úmb_idÚ	error_msgÚformatted_scheduleÚfull_error_msgÚexisting_rankr„   Ústage_actionsÚstage_index_to_rank_mappings             €€€r?   Ú_process_actionz+_validate_schedule.<locals>._process_actionn  s(  ø€ àÔ!ˆØÔ'ˆØÔ'ˆà•AŠ:ˆ:Ø˜$Ô¥Ô"×&Ò& uÑ-Ô-Ð-Ñ-Ø•aŠZˆZØ˜M¨$Ô/µÔ2Ð2Ð2ðH˜Dð Hð H¨ð Hð HÐQUð Hð HØ"'ðHð Hð Hð õ &<Ø¨tð&ñ &ô &Ð"ð !ÐSÐSÐ?QÐSÐSð õ % ^Ñ4Ô4Ð4Ø˜$Ô¥Ô"×&Ò& uÑ-Ô-Ð-Ð-Ø•aŠZˆZØ˜M¨$Ô/µÔ2Ð2Ð2ðH˜Dð Hð H¨ð Hð HÐRVð Hð HØ"'ðHð Hð Hð õ &<Ø¨tð&ñ &ô &Ð"ð !ÐSÐSÐ?QÐSÐSð õ % ^Ñ4Ô4Ð4Ø˜$Ô¥Ô"×&Ò& uÑ-Ô-Ð-Ð-Ø•aŠZˆZØ˜M¨$Ô/µÔ2Ð2Ð2ðO˜Dð Oð O¨ð Oð OÐSWð Oð OØ"'ðOð Oð Oð õ &<Ø¨tð&ñ &ô &Ð"ð !ÐSÐSÐ?QÐSÐSð õ % ^Ñ4Ô4Ð4Ø˜$Ô¥Ô"×&Ò& uÑ-Ô-Ð-àÐ2Ð2Ð2Ø04Ð'¨Ñ-Ð-Ð-à7¸Ô=ˆMØ˜MÒ)Ð)Ý$Øv˜DÐvÐv¨ÐvÐv°tÐvÐvÐW[ÐvÐvÐgtÐvÐvñô ð ð *Ð)rK   r�   r  z: Got an invalid action: z, expected instance of _ActionzGot r•   z microbatches for stage z, expected z(Invalid backward microbatches for stage z8: I and W must have equal counts,             but got I=z, W=r–   z: expected z( total backwards,             but got B=z, I=)ru   r  r£   rM   rt   rž   rÚ   rQ   r,   r5   r-   r.   )r„   r•  rc  r  rª   r  r#  r8   r\   r  Úf_mbÚb_mbÚi_mbÚw_mbr  r  s   `             @@r?   Ú_validate_scheduler  S  s?  øøø€ õ �‰LŒL˜MÒ)Ð)ÝØgÀÐgÐgÕY\Ð]dÑYeÔYeÐgÐgñ
ô 
ð 	
õ �mÑ$Ô$ð Qð QˆØ�wÐÐÝ Ð!OÈÐ!OÐ!OÑPÔPÐPð ð
=ð =õ ˜jÑ)Ô)ð=ñ =ô =€Mð #%Ðð:¥ð :­sð :½#ð :ð :ð :ð :ð :ð :ð :ð :ðx ð 4ð 4ˆÝ% g¨d¤mÑ4Ô4ð 	4ð 	4‰LˆD�&Øˆ~ØÝ˜f¥gÑ.Ô.ð Ý$Øn˜DÐnÐn¨ÐnÐnÈÐnÐnÐnñô ð ð
 Ô!Ð-à"(Ô"4ð <ð <�JØ#�O J°°dÑ;Ô;Ð;Ð;ð<ð  � ¨¨dÑ3Ô3Ð3Ð3ð	4ð" ð ð ˆÝ�= Ô&¥qÔ)Ñ*Ô*ˆÝ�= Ô&¥qÔ)Ñ*Ô*ˆÝ�= Ô&¥qÔ)Ñ*Ô*ˆÝ�= Ô&¥qÔ)Ñ*Ô*ˆàÐ(Ò(Ð(Ý Ø\�tÐ\Ð\�aÐ\Ð\¸Ð\Ð\ÐJZÐ\Ð\ñô ð ð ˜’�Ý ð(¸4ð (ð (Øð(ð (Ø!%ð(ð (ñô ð ð
 ˜˜t™¨Ñ)Ñ)Ð-=Ò=Ð=Ý ð2¸4ð 2ð 2ÐL\ð 2ð 2Øð2ð 2Ø!%ð2ð 2Ø+/ð2ð 2ñô ð ð >ð
 'Ð&rK   c                   óÜ  ‡ — e Zd ZdZ	 	 	 	 	 	 	 d$dee         dededz  dee	df         dz  d	e
ee	f         dz  d
e
eef         ee         z  dz  dedz  dedefˆ fd„Z	 d%deedf         fd„Zd&d„Zde
eeedz           f         ddfd„Zd„ Z	 d'deded         fd„Zdddddœdedz  dede
eef         dz  fd„Z	 	 	 	 	 	 d(d edz  d!edz  d"edz  dedz  dede
eef         dz  fd#„Zˆ xZS ))r"   aX  
    Base class for multi-stage schedules.
    Implements the `step` method.

    Gradients are scaled by num_microbatches depending on the `scale_grads` argument, defaulting to True.  This setting
    should match the configuration of your loss_fn, which may either average losses (scale_grads=True)
    or sum losses (scale_grads=False).
    NTrÞ   r¶   r·   r¸   .r¹   rº   Úuse_full_backwardr»   Úbackward_requires_autogradc
                 óÖ  •‡— t          ¦   «                              ||||||¬¦  «         || _        |d         j        | _        |d         j        | _        |d         j        | _        t          | j        | j        ¦  «        | _
        | j        D ]}
| j
        |
_
        Œd| _        d| _        | j        d uŠˆfd„| _        i | _        |	| _        |�t"                               d¦  «         d S d S )Nr`  r   Fc                 ó   •— | j         o‰S rS   r×   )rË   Úhas_losss    €r?   rÑ  z0PipelineScheduleMulti.__init__.<locals>.<lambda>  s   ø€ °%´-Ð2LÀH€ rK   zDeprecation warning: 'use_full_backward' is no longer supported. Simply stop passing it, and everything should still work fine.)ra  rÇ   Ú_stagesrc  rd  Ú
group_sizer•  Ú
group_rankrª   r   Ústage_index_to_group_rankÚ_stages_forward_initializedÚ_stages_backward_initializedr¾   Ú_should_compute_lossr€   Ú_backward_requires_autogradrÄ   Úwarning)rV   rÞ   r¶   r·   r¸   r¹   rº   r  r»   r  rË   r   rÆ   s              @€r?   rÇ   zPipelineScheduleMulti.__init__ß  s(  øø€ õ 	‰Œ×ÒØ)ØØ+Ø/Ø/Ø#ð 	ñ 	
ô 	
ð 	
ð ˆŒØ! !œ9Ô/ˆÔØ# AœYÔ1ˆÔØ˜1”IÔ(ˆŒ	å)GØÔ Ô 0ñ*
ô *
ˆÔ&ð ”\ð 	Mð 	MˆEØ.2Ô.LˆEÔ+Ð+à+0ˆÔ(Ø,1ˆÔ)ð œ¨dÐ2ˆØ$LÐ$LÐ$LÐ$LˆÔ!ð @BˆÔð
 ,FˆÔ(àÐ(Ý�NŠNðQñô ð ð ð ð )Ð(rK   rù   c           	      óø   — | j         o| j        | j        k    }| j         }|                      | j        |||| j         | j        |¬¦  «        \  | _         | _        | j         r|r|r|                      ¦   «          d S d S d S rj  )r%  rÂ   r&  r  r!  Ú&_validate_adjacent_stage_communication)rV   rù   rú   rû   rÏ   Úreinit_for_mode_switchÚforward_initialized_befores          r?   Ú_initialize_stagesz(PipelineScheduleMulti._initialize_stages  sÀ   € ð "&Ô!Að "
ØÔ $Ô"CÒCð 	ð &*Ô%EÐ"ð ×&Ò&ØŒLØØØØÔ,ØÔ-Ø#ð 'ñ 
ô 
ñ	
ØÔ,ØÔ-ð Ô+ð 	:Ø*ð	:Ø.Dð	:ð ×7Ò7Ñ9Ô9Ð9Ð9Ð9ð	:ð 	:ð 	:ð 	:rK   r9   c           
      ó°  — dt           dt          dt          t                    dt          t                    ddf
d„}| j        D ]•}|j        }d„ |j        d	         D ¦   «         }|j        rt          ¦   «         n|d
z
  h} ||d||¦  «         d„ |j                             ¦   «         D ¦   «         }|j	        rt          ¦   «         n|d
z   h} ||d||¦  «         Œ–dS )zGValidate that stage communication follows adjacent-stage topology only.r»  Ú	directionÚactual_stage_indicesÚexpected_stage_indicesr9   Nc                 ó    — ||z
  }|rFt          d| › d|› dt          |¦  «        › dt          |¦  «        › dt          |¦  «        › d�¦  «        ‚d S )NzLPipelineScheduleMulti only supports adjacent-stage communication, but stage z has z stages z with non-adjacent stages z (allowed adjacent stages: z\). This commonly indicates skip connections, which are unsupported in this schedule runtime.)r=   r¥   )r»  r0  r1  r2  Únon_adjacent_stage_indicess        r?   Ú_check_stage_indiceszZPipelineScheduleMulti._validate_adjacent_stage_communication.<locals>._check_stage_indices1  sž   € ð *>Ð@VÑ)VÐ&Ø)ð 
Ý"ð-Ø09ð-ð -Ø@Ið-ð -å$Ð%9Ñ:Ô:ð-ð -õ ,2Ð2LÑ+MÔ+Mð-ð -õ
 Ð4Ñ5Ô5ð-ð -ð -ñ	ô 	ð 	ð
ð 
rK   c                 óT   — h | ]%}t          |t          ¦  «        r|j        ®|j        ’Œ&S rS   )rÚ   r   Úsource)r[   rÅ   s     r?   r  zOPipelineScheduleMulti._validate_adjacent_stage_communication.<locals>.<setcomp>F  s@   € ð 1ð 1ð 1àÝ˜d¥IÑ.Ô.ð1ð 48´;Ð3Jð ”à3JÐ3JÐ3JrK   r   r   zforward recvc                 ó    — h | ]}|D ]}|®|’ŒŒS rS   rJ   )r[   ÚdstsÚdsts      r?   r  zOPipelineScheduleMulti._validate_adjacent_stage_communication.<locals>.<setcomp>U  s;   € ð /ð /ð /àØð/ð /ð Ø�?ð ð #�?�?�?rK   zforward send)
rt   rI   rÂ  r!  rN   Úargs_recv_infor  Úact_send_infor¤   rÉ   )rV   r5  rË   r»  Úactual_fwd_recv_sourcesÚexpected_fwd_recv_sourcesÚactual_fwd_send_destsÚexpected_fwd_send_destss           r?   r+  z<PipelineScheduleMulti._validate_adjacent_stage_communication.  sH  € ð	Ýð	åð	õ #&¥c¤(ð	õ %(­¤Hð		ð
 ð	ð 	ð 	ð 	ð& ”\ð 	ð 	ˆEØÔ)ˆIð1ð 1à!Ô0°Ô3ð1ñ 1ô 1Ð#ð
 27´Ð(T­©¬¨ÀiÐRSÁmÀ_Ð%Ø Ð ØØØ'Ø)ñ	ô ð ð/ð /à!Ô/×6Ò6Ñ8Ô8ð/ñ /ô /Ð!ð 05¬}Ð&Q¥c¡e¤e eÀ9ÈqÁ=À/Ð#Ø Ð ØØØ%Ø'ñ	ô ð ð ð1	ð 	rK   r„   c                 ó~   — t          || j        | j        | j        ¦  «        | _        | j        D ]}| j        |_        ŒdS )z]
        Allocates the stage index to rank mapping which is needed for communication
        N)r  r•  rd  r½   r$  r!  )rV   r„   rË   s      r?   Ú_validate_and_set_stage_mappingz5PipelineScheduleMulti._validate_and_set_stage_mappingc  sZ   € õ *<ØØÔØÔØÔ ñ	*
ô *
ˆÔ&ð ”\ð 	Mð 	MˆEØ.2Ô.LˆEÔ+Ð+ð	Mð 	MrK   c                 óÚ   — t          |dd¬¦  «        5 }t          j        |¦  «        }| j        D ]"}|                     | j        |         ¦  «         Œ#	 ddd¦  «         dS # 1 swxY w Y   dS )úQDump a CSV representation of the schedule into a file with the provided filename.r]  ri   ©ÚnewlineN)ÚopenÚcsvÚwriterr€   Úwriterow)rV   ÚfilenameÚcsvfilerI  rª   s        r?   Ú	_dump_csvzPipelineScheduleMulti._dump_csvr  s»   € å�(˜C¨Ð,Ñ,Ô,ð 	;°Ý”Z Ñ(Ô(ˆFØÔ+ð ;ð ;�Ø—’ Ô 3°DÔ 9Ñ:Ô:Ð:Ð:ð;ð	;ð 	;ð 	;ñ 	;ô 	;ð 	;ð 	;ð 	;ð 	;ð 	;ð 	;ð 	;øøøð 	;ð 	;ð 	;ð 	;ð 	;ð 	;s   “?A Á A$Á'A$Úcompute_onlyrK  Úformat©rN  Úcompute_commsc                 ó8  — |dk    rt          d|› �¦  «        ‚t          |d¬¦  «        5 }t          j        |¦  «        }t	          |¦  «        D ]\  }}d„ |D ¦   «         | j        |<   Œ	 ddd¦  «         n# 1 swxY w Y   |                      | j        ¦  «         dS )z÷Load a CSV representation of the schedule from a file with the provided filename.
        This API will most likely get renamed/refactored so is marked as internal for now.

        format must be "compute_only" for PipelineScheduleMulti.
        rN  z#format must be "compute_only", got ri   rE  c                 óB   — g | ]}t                                |¦  «        ‘ŒS rJ   ©rM   r@   ©r[   rÐ  s     r?   r]   z3PipelineScheduleMulti._load_csv.<locals>.<listcomp>ˆ  s&   € Ð,NÐ,NÐ,NÀQ­W×-=Ò-=¸aÑ-@Ô-@Ð,NÐ,NÐ,NrK   N)r  rG  rH  Úreaderrž   r€   rB  )rV   rK  rO  rL  rV  rª   rŸ   s          r?   Ú	_load_csvzPipelineScheduleMulti._load_csvy  s
  € ð �^Ò#Ð#Ý Ð!OÀvÐ!OÐ!OÑPÔPÐPÝ�( BÐ'Ñ'Ô'ð 	O¨7Ý”Z Ñ(Ô(ˆFÝ& vÑ.Ô.ð Oð O‘	��cØ,NÐ,NÈ#Ð,NÑ,NÔ,N�Ô# DÑ)Ð)ðOð	Oð 	Oð 	Oñ 	Oô 	Oð 	Oð 	Oð 	Oð 	Oð 	Oð 	Oøøøð 	Oð 	Oð 	Oð 	Oð 	×,Ò,¨TÔ-@ÑAÔAÐAÐAÐAs   ª>A5Á5A9Á<A9r   rß   r  rÏ   c                óì  — | j         r)| j        r"t          j        ¦   «         st	          d¦  «        ‚| j        D ]}| j         |_        Œ| j        D ]}|                     ¦   «          Œ|                      ||¦  «        \  }}	|�(t          t          |t          | j        ¦  «        ¦  «        nd}
|                      ||	|
|||¬¦  «         | j        D ]'}|j        r|r|                      |j        ¦  «        c S Œ(dS rn  )rÂ   r(  r  ro  r=   r!  râ   rp  r3  r¦   r   rq  r½   r  rÉ   r6  r4  )rV   rû   rß   r  rÏ   rù   rú   rË   r1  r2  rr  s              r?   r#  zPipelineScheduleMulti.stepŽ  sW  € ð, Ôð		àÔ0ð		õ Ô)Ñ+Ô+ð		õ
 ð.ñô ð ð ”\ð 	4ð 	4ˆEØ!%Ô!3ˆEÔÐð ”\ð 	)ð 	)ˆEØ×&Ò&Ñ(Ô(Ð(Ð(ð $(×#5Ò#5°d¸FÑ#CÔ#CÑ ˆ
�Lð
 Ð!õ •˜vÕ'9¸4Ô;OÑPÔPÑQÔQÐQàð 	ð 	×ÒØØØØØØ#ð 	 ñ 	
ô 	
ð 	
ð ”\ð 	@ð 	@ˆEØŒ}ð @ ð @Ø×*Ò*¨5Ô+>Ñ?Ô?Ð?Ð?Ð?øàˆtrK   r  r  rÍ   c           
      óJ  — |                       ||||¦  «        \  }}|�|d         nd}|                      |d         |d         ||¦  «         d„ | j        D ¦   «         }t          ¦   «         }	t          ¦   «         }
|D ]\}|dk    r#|	                     | j        |dz
           ¦  «         || j        dz
  k     r#|
                     | j        |dz            ¦  «         Œ]t          ¦   «         }t          | j	        | j
                 ¦  «        D �]�\  }}	 g }|��X|j        }|j        }|j        }|€t          d¦  «        ‚|t          j        k    rp||         }|                     |||         ||         |¬¦  «        }|                      |||||¦  «         |                     |                     |¦  «        ¦  «         �n²|t          j        k    r¨||         }|                      ||¦  «        }||xx         dz  cc<   ||         | j        k    }| j        r| j        nd}|                     ||d|¬¦  «         |r|                     |¦  «         |                     |                     |¦  «        ¦  «         nú|t          j        k    r`||         }|                      ||¦  «        }|                     ||d	d	¬¦  «         |                     |                     |¦  «        ¦  «         nŠ|t          j        k    rh||         }||xx         dz  cc<   ||         | j        k    }| j        r| j        nd}|                     ||¬
¦  «         |r|                     |¦  «         nt=          d|› �¦  «        ‚|	D ]È}| j	        |         }d}|t?          |¦  «        k     r||         }|�š|j        }|j        }|j        }|€t          d¦  «        ‚|t          j        k    r;|dz   |v r3||dz            }|                     |                      |¦  «        ¦  «         ŒŸ|t*          t6          t8          fv rŒ¶t=          d|› �¦  «        ‚ŒÉ|
D ]Â}| j	        |         }d}|t?          |¦  «        k     r||         }|�”|j        }|j        }|j        }|€t          d¦  «        ‚|t           t8          fv rŒe|t6          t*          fv r;|dz
  |v r3||dz
           }|                     | !                    |¦  «        ¦  «         Œ°t=          d|› �¦  «        ‚ŒÃtE          tG          |¦  «        ¦  «         �Œ# tH          $ rd}tJ           &                    d| j
        | j'        j(        |||¦  «         tJ           &                    dtS          | j	        |¬¦  «        ¦  «         |‚d}~ww xY w|  *                    | j        |¦  «         dS )úì
        Operate on the microbatches for looped schedules (multiple stages on each rank).

        TODO: Does not use sorted_batch_isend_irecv(). As a result, this schedule does
        not support models with skip connections.
        Nr   c                 ó   — i | ]
}|j         |“ŒS rJ   ©rN   rØ   s     r?   rá  z<PipelineScheduleMulti._step_microbatches.<locals>.<dictcomp>è  ó*   € ð ?
ð ?
ð ?
Ø).ˆEÔ˜uð?
ð ?
ð ?
rK   r   zCAll currently supported action types require valid microbatch_indexr‡  T©rÐ   Úfull_backwardr‹  F©r‹  zUnknown computation type zi[Rank %s] pipeline schedule %s caught the following exception '%s' at time_step %s when running action %sz%sr  )+r.  r.  r!  rÂ  rÃ  r$  rd  r   rž   r€   rª   rO   rP   rN   r  r+   rD   r€  rÑ   rÝ   r�  rG   rÔ   r½   r»   rŽ  r�  rE   rF   Úbackward_weight_one_chunkr<   ru   r  r�  rò   ró   Ú	ExceptionrÄ   ÚerrorrÆ   rA   r³   rá   )rV   r  r  rÍ   rß   r  rÏ   r‚  Ústage_index_to_stageÚall_prev_ranksÚall_next_ranksrN   Úbackward_counterÚ	time_stepr8   rX  rO   rÎ   rË   rÌ   rÐ   r‹  Úgrad_scale_factorÚ	prev_rankÚprev_rank_opsÚprev_rank_actionÚ	next_rankÚnext_rank_opsÚnext_rank_actionÚes                                 r?   r  z(PipelineScheduleMulti._step_microbatchesÑ  s  € ð "×/Ò/°¸ÀJÐPVÑWÔWÑˆ�Ø.8Ð.D˜Z¨œ]˜]È$ÐØ×ÒØ�AŒJ˜	 !œÐ&8¸+ñ	
ô 	
ð 	
ð?
ð ?
Ø26´,ð?
ñ ?
ô ?
Ðõ $'¡5¤5ˆÝ#&¡5¤5ˆØ/ð 	Tð 	TˆKà˜QŠˆØ×"Ò" 4Ô#AÀ+ÐPQÁ/Ô#RÑSÔSÐSØ˜TÔ-°Ñ1Ò1Ð1Ø×"Ò" 4Ô#AÀ+ÐPQÁ/Ô#RÑSÔSÐSøå)0©¬ÐÝ!*¨4Ô+>¸t¼yÔ+IÑ!JÔ!Jð \	ñ \	ÑˆI�vð[Ø(*�ØÑ%Ø'-Ô'>Ð$Ø%Ô6�HØ"(Ô"4�KØÐ'Ý,Øañô ð ð (Õ+;Ô+CÒCÐCà 4°[Ô A˜Ø!&×!8Ò!8Ø$Ø# HÔ-Ø% hÔ/Ø0>ð	 "9ñ "ô "˜ð ×0Ò0Ø! 6¨:°xÀñô ð ð Ÿ
š
 5×#9Ò#9¸(Ñ#CÔ#CÑDÔDÐDÑDØ)Õ-=Ô-KÒKÐKà 4°[Ô A˜Ø#×3Ò3°E¸8ÑDÔD˜Ø(¨Ð5Ð5Ô5¸Ñ:Ð5Ð5Ñ5à,¨[Ô9¸TÔ=QÒQð &ð 59Ô4DÐK˜DÔ0Ð0È!ð *ð ×0Ò0Ø$Ø!%Ø*.Ø*7ð	 1ñ ô ð ð )ð AØ!×-Ò-Ð.?Ñ@Ô@Ð@àŸ
š
 5×#9Ò#9¸(Ñ#CÔ#CÑDÔDÐDÐDØ)Õ-=Ô-LÒLÐLà 4°[Ô A˜Ø#×3Ò3°E¸8ÑDÔD˜Ø×0Ò0Ø$Ø!%Ø*/Ø*/ð	 1ñ ô ð ð Ÿ
š
 5×#9Ò#9¸(Ñ#CÔ#CÑDÔDÐDÐDØ)Õ-=Ô-MÒMÐMà 4°[Ô A˜Ø(¨Ð5Ð5Ô5¸Ñ:Ð5Ð5Ñ5à,¨[Ô9¸TÔ=QÒQð &ð 59Ô4DÐK˜DÔ0Ð0È!ð *ð ×7Ò7Ø$Ø*7ð 8ñ ô ð ð )ð AØ!×-Ò-Ð.?Ñ@Ô@Ð@øå(Ð)WÐEUÐ)WÐ)WÑXÔXÐXð "0ð ð �IØ$(Ô$7¸	Ô$B�MØ'+Ð$Ø ¥3 }Ñ#5Ô#5Ò5Ð5Ø+8¸Ô+CÐ(Ø'Ð3Ø+;Ô+LÐ(Ø#3Ô#D˜Ø&6Ô&B˜Ø#Ð+Ý"0Ø eñ#ô #ð ð ,Õ/?Ô/GÒGÐGà*¨Q™Ð2FÐFÐFð )=¸[È1¹_Ô(M Ø #§
¢
¨5×+AÒ+AÀ(Ñ+KÔ+KÑ LÔ LÐ LøØ-Ý)Ý*Ý+ð2ð ð ð !å",Ø NÐ<LÐ NÐ Nñ#ô #ð ð1 4ð6 "0ð ð �IØ$(Ô$7¸	Ô$B�MØ'+Ð$Ø ¥3 }Ñ#5Ô#5Ò5Ð5Ø+8¸Ô+CÐ(Ø'Ð3Ø+;Ô+LÐ(Ø#3Ô#D˜Ø&6Ô&B˜Ø (Ð 4Ý"0Ø eñ#ô #ð ð ,µ½Ð/IÐIÐIà Ø-µ.Å-Ð1PÐPÐPà*¨Q™Ð2FÐFÐFð )=¸[È1¹_Ô(M Ø #§
¢
¨5×+AÒ+AÀ(Ñ+KÔ+KÑ LÔ LÐ Løå",Ø NÐ<LÐ NÐ Nñ#ô #ð ð) 4õ2  ¥
¨3¡¤Ñ0Ô0Ð0Ñ0øÝð ð ð Ý—’ð(à”IØ”NÔ+ØØØñô ð õ —’ØÝ*ØÔ+¸yðñ ô ñô ð ð �øøøøð!øøøð$ 	×Ò˜DœL¨&Ñ1Ô1Ð1Ð1Ð1s   ÄP	TÔ
VÔ!AV Ö V)NNNNNTTrt  )r9   N©rN  r8  )rA   rB   rC   ru  r¦   r   rt   r   rp   r   r:  rI   r   r|   rÇ   r.  r+  rM   rB  rM  r   rW  r#  r  rv  rw  s   @r?   r"   r"   Õ  sÅ  ø€ € € € € ðð ð $(Ø>BØ?CØ@DØ)-Ø Ø+/ð4ð 4àÐ'Ô(ð4ð ð4ð ˜D‘ð	4ð
 ˜°Ð3Ô4°tÑ;ð4ð    _Ð 4Ô5¸Ñ<ð4ð    S œ>¨E°#¬JÑ6¸Ñ=ð4ð   $™;ð4ð ð4ð %)ð4ð 4ð 4ð 4ð 4ð 4ðn GKð:ð :Ø˜#˜s˜(”Oð:ð :ð :ð :ð23ð 3ð 3ð 3ðjMØ˜C  g°¡nÔ!5Ð5Ô6ðMà	ðMð Mð Mð Mð;ð ;ð ;ð <JðBð BàðBð Ð7Ô8ðBð Bð Bð Bð0 Ø"Ø#Ø-1ðAð Að Að �t‘ð	Að
 ðAð ˜#˜s˜(”^ dÑ*ðAð Að Að AðJ  $Ø!%Ø"&Ø"Ø#Ø-1ðE2ð E2à˜‘ðE2ð ˜$‘;ðE2ð ˜4‘Kð	E2ð
 �t‘ðE2ð ðE2ð ˜#˜s˜(”^ dÑ*ðE2ð E2ð E2ð E2ð E2ð E2ð E2ð E2rK   r"   c                   ó†   — e Zd ZU dZeed<   dZee         dz  ed<   dZ	ee
         dz  ed<   dZedz  ed<   dZedz  ed<   dS )Ú_PipelineContextz=Context passed to custom functions during pipeline execution.Úschedule_refNr  r  rÍ   rß   )rA   rB   rC   ru  rµ   rz   r  r¦   rp   r  r:  rÍ   rß   rJ   rK   r?   rs  rs  ™  s~   € € € € € € àGÐGà#Ð#Ð#Ñ#Ø"&€GˆT�%Œ[˜4ÑÐ&Ð&Ñ&Ø#'€Iˆt�DŒz˜DÑ Ð'Ð'Ñ'Ø"€J��t‘Ð"Ð"Ñ"Ø€FˆD�4‰KÐÐÑÐÐrK   rs  c                   ó"   — e Zd Zdededdfd„ZdS )Ú_CustomFunctionProtocolr8   Úctxr9   Nc                 ó   — d S rS   rJ   )rV   r8   rw  s      r?   Ú__call__z _CustomFunctionProtocol.__call__¥  s   € € € rK   )rA   rB   rC   rM   rs  ry  rJ   rK   r?   rv  rv  ¤  s,   € € € € € ØK˜wÐKÐ-=ÐKÀ$ÐKÐKÐKÐKÐKÐKrK   rv  c                   ó.  ‡ — e Zd ZdZˆ fd„Zdededdfd„Z	 dd	ee	e
edz           f         d
ed         fˆ fd„Z	 dded
ed         fˆ fd„Z	 dded
ed         fd„Zd„ Zdefd„Z	 	 	 	 	 	 dde
dz  de
dz  de
dz  de
dz  dedeeef         dz  fd„Zˆ xZS )Ú_PipelineScheduleRuntimea%  
    Provides a simple runtime that requires a 'schedule IR' including specified communication operations.

    Can be instantiated directly by creating _PipelineScheduleRuntime and calling load_csv, or can be
    subclassed and the subclass can be responsible for creating a schedule IR.
    c                 ó  •— |                      dd¦  «        | _         t          ¦   «         j        |i |¤Ž i | _        t          ¦   «         | _        i | _        i | _        t          t          ¦  «        | _        t          ¦   «         | _        d S )NÚdefer_pp_recvF)rÙ  Ú_defer_pp_recvra  rÇ   Ú_comp_type_to_function_mapr   rg  Úbwd_recv_opsÚfwd_recv_opsr   r¦   Úunshard_opsrÂ  Úunsharded_stages)rV   rù   rú   rÆ   s      €r?   rÇ   z!_PipelineScheduleRuntime.__init__°  s‚   ø€ Ø$*§J¢J¨ÀÑ$FÔ$FˆÔØ�‰ŒÔ˜$Ð) &Ð)Ð)Ð)àLNˆÔ'å.5©i¬iˆÔð EGˆÔØDFˆÔõ <GÅtÑ;LÔ;LˆÔÝ #¡¤ˆÔÐÐrK   rO   Úcustom_functionr9   Nc           	      óð   — |t           t          t          t          t          t
          t          t          fvrt          d|› d�¦  «        ‚|| j	        v rt                               d|¦  «         || j	        |<   dS )a~  
        Register a custom function to be executed for a specific computation type.

        Args:
            computation_type: The computation type for which to register the custom function
            custom_function: The function to execute when this computation type is encountered.
                Must have signature: (action: _Action, ctx: _PipelineContext) -> None
        r;   zŒ. Only FORWARD, FULL_BACKWARD,                 BACKWARD_INPUT, BACKWARD_WEIGHT, OVERLAP_F_B, UNSHARD, RESHARD and REDUCE_GRAD are supported.zTComputation type %s is already registered. Overwriting the existing custom function.N)rD   rG   rE   rF   r6   r/   r0   r7   r<   r  rÄ   r)  )rV   rO   r„  s      r?   Úregister_custom_functionz1_PipelineScheduleRuntime.register_custom_functionÀ  s¢   € ð ÝÝÝÝÝÝÝÝð	$
ð 	
ð 	
õ ðoÐ,<ð oð oð oñô ð ð ˜tÔ>Ð>Ð>Ý�NŠNð<à ñô ð ð =LˆÔ'Ð(8Ñ9Ð9Ð9rK   rN  r„   rO  rP  c                 ó  •‡ — t          ¦   «                              |¦  «         i ‰ _        |dk    r]|D ]X}g ‰ j        |<   ||         D ]C}|€t          dt	          |¦  «        › �¦  «        ‚‰ j        |                              |¦  «         ŒDŒYdS |dk    rè|                     ¦   «         D ]<\  }}t          |¦  «        D ]'\  }}|� |j        st          d|› d|› d|› d�¦  «        ‚Œ(Œ=|D ]G}t          ||         ¦  «        ‰ j        |<   t          ‰ j        |         ‰ j        ¦  «        ‰ j        |<   ŒHt          ‰ j        ˆ fd	„‰ j        ¬
¦  «        ‰ _        ‰ j        r t!          ‰ j        ˆ fd„¬¦  «        ‰ _        dS dS t#          d|›d�¦  «        ‚)zé
        Given an in-memory representation for a simple compute-only schedule, lower it to a complex schedule including
        communication actions.  Stores the schedule in self, and must be called before running step_mo()
        rQ  Nz$Expected action to be not None, got rN  z?Expected compute-only schedule but found communication action 'z
' at rank z, position ze. Communication actions (e.g. SEND_F, RECV_F, etc.) should not be present when format='compute_only'.c                 ó   •— ‰j         |          S rS   ©r$  ©rÐ  rV   s    €r?   rÑ  zG_PipelineScheduleRuntime._prepare_schedule_with_comms.<locals>.<lambda>	  s   ø€ ¨Ô(FÀqÔ(I€ rK   )rÝ  rc  c                 ó   •— ‰j         |          S rS   r‰  rŠ  s    €r?   rÑ  zG_PipelineScheduleRuntime._prepare_schedule_with_comms.<locals>.<lambda>	  s   ø€ ¨DÔ,JÈ1Ô,M€ rK   )rÝ  úformat=ú is not implemented)ra  rB  Úpipeline_order_with_commsr  r  ro   rU  rž   rf   r<   r×  r”  r½   rô  rd  r~  r  r  )rV   r„   rO  rª   r8   rÿ  rˆ   rÆ   s   `      €r?   Ú_prepare_schedule_with_commsz5_PipelineScheduleRuntime._prepare_schedule_with_commsç  sU  øø€ õ 	‰Œ×/Ò/°Ñ8Ô8Ð8àCEˆÔ&Ø�_Ò$Ð$Øð Hð H�Ø79�Ô.¨tÑ4Ø% dœmð Hð H�FØ�~Ý,ØQÅ4ÈÁ<Ä<ÐQÐQñô ð ð Ô2°4Ô8×?Ò?ÀÑGÔGÐGÐGðHðHð Hð �~Ò%Ð%à%,§]¢]¡_¤_ð 	ð 	Ñ!��kÝ!*¨;Ñ!7Ô!7ð ð ‘I�A�vØÐ)Ø%Ô3ð Ý",ð!UØ$*ð!Uð !UØ6:ð!Uð !UØGHð!Uð !Uð !Uñ#ô #ð øðð  ð ð �Ý7KØ˜D”Mñ8ô 8�Ô.¨tÑ4õ 8HØÔ2°4Ô8ØÔ(ñ8ô 8�Ô.¨tÑ4Ð4õ
 .<ØÔ.ØIÐIÐIÐIØÔ+ð.ñ .ô .ˆDÔ*ð Ô"ð Ý1@ØÔ2Ø"MÐ"MÐ"MÐ"Mð2ñ 2ô 2�Ô.Ð.Ð.ðð õ &Ð&E¨Ð&EÐ&EÐ&EÑFÔFÐFrK   rK  c                 ó¶  •— |dk    r=t          ¦   «                              |¦  «         |                      | j        ¦  «         dS |dk    r}i }t	          |d¬¦  «        5 }t          j        |¦  «        }t          |¦  «        D ]\  }}d„ |D ¦   «         ||<   Œ|                      ||¬¦  «         ddd¦  «         dS # 1 swxY w Y   dS t          d|›d	�¦  «        ‚)
a	  Loads a csv in simple format and then lowers it to include communication actions

        format must be either "compute_only" or "compute_comms".  If compute_only, the lowering passes
        will automatically be run to generate a compute_comms schedule.
        rN  rQ  ri   rE  c                 óB   — g | ]}t                                |¦  «        ‘ŒS rJ   rT  rU  s     r?   r]   z6_PipelineScheduleRuntime._load_csv.<locals>.<listcomp>7	  s&   € Ð$FÐ$FÐ$F¸Q¥W×%5Ò%5°aÑ%8Ô%8Ð$FÐ$FÐ$FrK   )rO  NrŒ  r�  )	ra  rW  r�  r€   rG  rH  rV  rž   r  )	rV   rK  rO  r„   rL  rV  rª   rŸ   rÆ   s	           €r?   rW  z"_PipelineScheduleRuntime._load_csv#	  sV  ø€ ð �^Ò#Ð#å‰GŒG×Ò˜hÑ'Ô'Ð'à×-Ò-¨dÔ.AÑBÔBÐBÐBÐBØ�Ò&Ð&ØˆGÝ�h¨Ð+Ñ+Ô+ð J¨wÝœ GÑ,Ô,�Ý!*¨6Ñ!2Ô!2ð Gð G‘I�D˜#Ø$FÐ$FÀ#Ð$FÑ$FÔ$F�G˜D‘M�MØ×1Ò1°'À&Ð1ÑIÔIÐIð	Jð Jð Jñ Jô Jð Jð Jð Jð Jð Jð Jð Jøøøð Jð Jð Jð Jð Jð Jõ &Ð&E¨Ð&EÐ&EÐ&EÑFÔFÐFs   ÁAB;Â;B?ÃB?rQ  c                 ó&  — |dk    r‚| j         €t          d¦  «        ‚t          |dd¬¦  «        5 }t          j        |¦  «        }| j         D ]"}|                     | j         |         ¦  «         Œ#	 ddd¦  «         dS # 1 swxY w Y   dS |dk    r‚| j        €t          d¦  «        ‚t          |dd¬¦  «        5 }t          j        |¦  «        }| j        D ]"}|                     | j        |         ¦  «         Œ#	 ddd¦  «         dS # 1 swxY w Y   dS dS )	rD  rN  Nz'Compute only schedule must be availabler]  ri   rE  rQ  z6Must initialize compute_comms schedule before dump_csv)r€   r  rG  rH  rI  rJ  rŽ  )rV   rK  rO  rL  rI  rª   s         r?   rM  z"_PipelineScheduleRuntime._dump_csv<	  sä  € ð �^Ò#Ð#ØÔ"Ð*Ý$Ð%NÑOÔOÐOÝ�h ¨RÐ0Ñ0Ô0ð ?°GÝœ GÑ,Ô,�Ø Ô/ð ?ð ?�DØ—O’O DÔ$7¸Ô$=Ñ>Ô>Ð>Ð>ð?ð?ð ?ð ?ñ ?ô ?ð ?ð ?ð ?ð ?ð ?ð ?ð ?øøøð ?ð ?ð ?ð ?ð ?ð ?ð �Ò&Ð&ØÔ-Ð5Ý$ØLñô ð õ �h ¨RÐ0Ñ0Ô0ð J°GÝœ GÑ,Ô,�Ø Ô:ð Jð J�DØ—O’O DÔ$BÀ4Ô$HÑIÔIÐIÐIðJðJð Jð Jñ Jô Jð Jð Jð Jð Jð Jð Jð Jøøøð Jð Jð Jð Jð Jð Jð 'Ð&s#   ¯?A<Á<B ÂB Â7?DÄDÄDc                 ó@   ‡ — t          ‰ j        ˆ fd„‰ j        ¦  «        S )Nc                 ó   •— ‰j         |          S rS   r‰  rŠ  s    €r?   rÑ  z4_PipelineScheduleRuntime._simulate.<locals>.<lambda>V	  s   ø€ �dÔ4°QÔ7€ rK   )Ú_simulate_comms_computerŽ  rd  rU   s   `r?   Ú	_simulatez"_PipelineScheduleRuntime._simulateS	  s-   ø€ Ý&ØÔ*Ø7Ð7Ð7Ð7ØÔñ
ô 
ð 	
rK   rË   c                 ó$  — t          |j        t          ¦  «        }|rq|j        }|| j        v rF| j        |         D ]}|                     ¦   «          Œ| j        |= | j                             |¦  «         || j        vrt          d|›�¦  «        ‚dS dS )zQIf an unshard is active for `stage_idx`, wait() it and mark `stage_idx` unshared.z*Attempted to compute on sharded stage_idx=N)	rÚ   Úsubmodr   rN   r‚  r\  rƒ  rÃ  r  )rV   rË   Ústage_uses_fsdpr»  r?  s        r?   Ú_assert_unshardedz*_PipelineScheduleRuntime._assert_unshardedZ	  s³   € å$ U¤\µ:Ñ>Ô>ˆØð 	VØÔ)ˆIØ˜DÔ,Ð,Ð,ØÔ*¨9Ô5ð ð �BØ—G’G‘I”I�I�IØÔ$ YÐ/ØÔ%×)Ò)¨)Ñ4Ô4Ð4Ø Ô 5Ð5Ð5Ý$Ð%TÈ	Ð%TÐ%TÑUÔUÐUð	Vð 	Vð 6Ð5rK   Tr  r  rÍ   rß   r  rÏ   c           	      óÞ  ‡ ‡‡‡‡‡‡‡— ‰                       ‰‰‰|¦  «        \  ŠŠ‰�‰d         nd}‰                      ‰d         ‰d         |‰¦  «         d„ ‰ j        D ¦   «         Š‰ j        €t	          d¦  «        ‚g Šdt
          ddfˆˆˆˆˆ ˆˆˆfd„}‰ j                             ¦   «          t          ‰ j        ‰ j	                 ¦  «        D �]9\  }	}
t                               d|	|
¦  «         	 t          t          |
¦  «        ¦  «        5  |
j        ‰ j        v r0t!          ‰ ‰‰‰|¦  «        } ‰ j        |
j                 |
|¦  «         nG|
j        t"          k    r,|
j        €t	          d	¦  «        ‚|
j        D ]} ||¦  «         Œn ||
¦  «         ddd¦  «         n# 1 swxY w Y   ŒÝ# t&          $ rQ}t                               d
|	|
¦  «         t                               t+          ‰ j        |	¬¦  «        ¦  «         |‚d}~ww xY w‰r#t-          ‰                     ¦   «         ¦  «         ‰°#t1          ‰ j        ¦  «        dk    rt	          d¦  «        ‚‰                      ‰ j        |¦  «         dS )rZ  Nr   c                 ó   — i | ]
}|j         |“ŒS rJ   r\  rØ   s     r?   rá  z?_PipelineScheduleRuntime._step_microbatches.<locals>.<dictcomp>~	  r]  rK   zLMust call _prepare_schedule_with_comms() before calling _step_microbatches()r8   r9   c                 óÌ  •— | j         }| j        �| j        nd}|dk    s)|t          t          t          fv st          d| ›d�¦  «        ‚| j        }‰|         }t          |j        t          ¦  «        }|dz   ‰v }|dz
  ‰v }|t          k    r7‰                     t          |                     |¦  «        ¦  «        ¦  «         d S |t          k    r7‰                     t          |                     |¦  «        ¦  «        ¦  «         d S |t           k    rO||f‰j        v rt          d|›d|›d�¦  «        ‚t          |                     |¦  «        ¦  «        ‰j        ||f<   d S |t&          k    rO||f‰j        v rt          d|›d|›d	�¦  «        ‚t          |                     |¦  «        ¦  «        ‰j        ||f<   d S |t          k    r¦|r |‰j        vr	|‰j        vst          d
|›d�¦  «        ‚|j                             ¦   «         D ]c}t          |t          ¦  «        sŒt3          t4          |                     d¬¦  «        ¦  «        }	‰j        |                              |	¦  «         Œbd S d S |t          k    rž|rš|‰j        vrt          d|›d�¦  «        ‚|‰j        v rt          d|›d�¦  «        ‚|j                             ¦   «         D ],}t          |t          ¦  «        sŒ|                     ¦   «          Œ-‰j                             |¦  «         d S d S |t<          k    rÈ‰                     |¦  «         |j         sI|sG||f‰j        vrt          d| ›d�¦  «        ‚tC          ‰j         "                    ||f¦  «        ¦  «         | #                    |‰|         ‰|         ‰¬¦  «        }
‰ $                    ||
‰|‰¦  «         |r!‰|dz             %                    |
|¦  «         d S d S |tL          k    r÷‰                     |¦  «         |j'        sI|sG||f‰j        vrt          d| ›d�¦  «        ‚tC          ‰j         "                    ||f¦  «        ¦  «         ‰ (                    ||¦  «        }‰j)        |xx         dz  cc<   ‰j)        |         ‰j*        k    }| +                    ||d|¬¦  «         |r4‰|dz
            ,                    | -                    |¦  «        |¦  «         d S d S |t\          k    rÌ‰                     |¦  «         |j'        sI|sG||f‰j        vrt          d| ›d�¦  «        ‚tC          ‰j         "                    ||f¦  «        ¦  «         ‰ (                    ||¦  «        }| +                    ||dd¬¦  «         |r4‰|dz
            ,                    | -                    |¦  «        |¦  «         d S d S |t^          k    rY‰                     |¦  «         ‰j)        |xx         dz  cc<   ‰j)        |         ‰j*        k    }| 0                    ||¬¦  «         d S |t          k    r'‰j1        r‰j*        nd}| 2                    |¦  «         d S tg          d| ›d�¦  «        ‚)Nrj   r   zaction=z missing mb_indexr   zRecv twice for stage_idx=z
 mb_index=z without executing forwardz without executing backwardzUnsharding the same stage_idx=z twiceT)Úasync_opzResharding stage_idx=z without unshardingz before finishing unshardzComputing action=z before receiving inputr‡  z Attempted to run compute action=r^  Fr`  z is unknown or unsupported)4rO   rP   r/   r0   r7   r  rN   rÚ   r˜  r   r1   ro   ró   r�  r3   r�  r2   r�  r  r4   r€  r�  rƒ  r‚  Úmodulesr   r   ÚunshardÚreshardrÍ  rD   rš  r  rò   rÙ  r€  rÑ   Úset_local_fwd_inputrG   rÉ   rÔ   rg  r½   rŽ  Úset_local_bwd_inputÚget_local_bwd_outputrE   rF   ra  r»   r�  r<   )r8   Ú	comp_typerÎ   r»  rË   r™  Úis_next_stage_on_this_rankÚis_prev_stage_on_this_rankÚ	submoduleÚhandlerÌ   rÐ   r‹  ri  r  r  rÏ   r  rV   Úsend_opsrd  rÍ   s                 €€€€€€€€r?   Ú_perform_actionzD_PipelineScheduleRuntime._step_microbatches.<locals>._perform_actionŠ	  sP  ø€ ØÔ/ˆIà+1Ô+BÐ+N�Ô'Ð'ÐTVð ð ˜A’�ØåÝÝððð õ %Ð%B¨Ð%BÐ%BÐ%BÑCÔCÐCØÔ*ˆIØ(¨Ô3ˆEÝ(¨¬µzÑBÔBˆOà)2°Q©Ð:NÐ)NÐ&Ø)2°Q©Ð:NÐ)NÐ&ð �FÒ"Ð"Ø—’¥
¨5×+AÒ+AÀ(Ñ+KÔ+KÑ LÔ LÑMÔMÐMÐMÐMØ�fÒ$Ð$Ø—’¥
¨5×+AÒ+AÀ(Ñ+KÔ+KÑ LÔ LÑMÔMÐMÐMÐMØ�fÒ$Ð$Ø˜xÐ(¨DÔ,=Ð=Ð=Ý(Ø\¨)Ð\Ð\°xÐ\Ð\Ð\ñô ð õ <FØ×*Ò*¨8Ñ4Ô4ñ<ô <�Ô! 9¨hÐ"7Ñ8Ð8Ð8ð �fÒ$Ð$Ø˜xÐ(¨DÔ,=Ð=Ð=Ý(Ø]¨)Ð]Ð]°xÐ]Ð]Ð]ñô ð õ <FØ×*Ò*¨8Ñ4Ô4ñ<ô <�Ô! 9¨hÐ"7Ñ8Ð8Ð8ð �gÒ%Ð%Ø"ð 
Cà!¨Ô)>Ð>Ð>Ø%¨TÔ-=Ð=Ð=å,Ð-VÀIÐ-VÐ-VÐ-VÑWÔWÐWØ%*¤\×%9Ò%9Ñ%;Ô%;ð Cð C˜	Ý)¨)µZÑ@Ô@ð %Ø$Ý!%¥m°Y×5FÒ5FÐPTÐ5FÑ5UÔ5UÑ!VÔ!V˜ØÔ(¨Ô3×:Ò:¸6ÑBÔBÐBÐBð
Cð 
CðCð Cð
 �gÒ%Ð%Ø"ð <Ø ¨Ô(=Ð=Ð=Ý,ØI¨)ÐIÐIÐIñô ð ð ! DÔ$4Ð4Ð4Ý,ØO¨)ÐOÐOÐOñô ð ð &+¤\×%9Ò%9Ñ%;Ô%;ð ,ð ,˜	Ý)¨)µZÑ@Ô@ð %Ø$Ø!×)Ò)Ñ+Ô+Ð+Ð+ØÔ)×0Ò0°Ñ;Ô;Ð;Ð;Ð;ð<ð <ð �gÒ%Ð%Ø×&Ò& uÑ-Ô-Ð-ð œð	Rð 7ð	Rð
 " 8Ð,°DÔ4EÐEÐEÝ,ØI¨ÐIÐIÐIñô ð õ $ DÔ$5×$9Ò$9¸9ÀhÐ:OÑ$PÔ$PÑQÔQÐQà×0Ò0ØØ˜HÔ%Ø˜hÔ'Ø(6ð	 1ñ ô �ð ×(Ò(Ø˜6 :¨x¸ñô ð ð .ð Ø(¨°Q©Ô7×KÒKØ ñô ð ð ð ðð ð
 �mÒ+Ð+Ø×&Ò& uÑ-Ô-Ð-ð œð	Rð 7ð	Rð
 " 8Ð,°DÔ4EÐEÐEÝ,ØX¸ÐXÐXÐXñô ð õ $ DÔ$5×$9Ò$9¸9ÀhÐ:OÑ$PÔ$PÑQÔQÐQØ×+Ò+¨E°8Ñ<Ô<�ØÔ% iÐ0Ð0Ô0°AÑ5Ð0Ð0Ñ0Ø $Ô 5°iÔ @ÀDÔDXÒ X�Ø×(Ò(ØØØ"&Ø"/ð	 )ñ ô ð ð .ð Ø(¨°Q©Ô7×KÒKØ×2Ò2°8Ñ<Ô<¸hñô ð ð ð ðð ð �nÒ,Ð,Ø×&Ò& uÑ-Ô-Ð-à”}ð RÐ-Gð RØ! 8Ð,°DÔ4EÐEÐEÝ,ØX¸ÐXÐXÐXñô ð õ $ DÔ$5×$9Ò$9¸9ÀhÐ:OÑ$PÔ$PÑQÔQÐQØ×+Ò+¨E°8Ñ<Ô<�Ø×(Ò(ØØØ"'Ø"'ð	 )ñ ô ð ð .ð Ø(¨°Q©Ô7×KÒKØ×2Ò2°8Ñ<Ô<¸hñô ð ð ð ðð ð �oÒ-Ð-Ø×&Ò& uÑ-Ô-Ð-ØÔ% iÐ0Ð0Ô0°AÑ5Ð0Ð0Ñ0Ø $Ô 5°iÔ @ÀDÔDXÒ X�Ø×/Ò/ØØ"/ð 0ñ ô ð ð ð ð �kÒ)Ð)Ø<@Ô<LÐ$S DÔ$8Ð$8ÐRSÐ!Ø×)Ò)Ð*;Ñ<Ô<Ð<Ð<Ð<å Ð!G FÐ!GÐ!GÐ!GÑHÔHÐHrK   z8_PipelineScheduleRuntime running time_step %d, action %szsub_actions must be setz\_PipelineScheduleRuntime caught exception at step %s when running action %s.  Full Schedule:r  zUnused unshard operations)r.  r.  r!  rŽ  r  rM   rg  rÜ   rž   rª   rÄ   rð   r   r   rO   r  rs  r6   rQ   rb  rc  r³   rò   rÙ  ru   r‚  rá   )rV   r  r  rÍ   rß   r  rÏ   r‚  r«  rh  r8   rw  Úsub_arp  rª  rd  s   ```` ``       @@r?   r  z+_PipelineScheduleRuntime._step_microbatchesg	  s–  øøøøøøøø€ ð "×/Ò/°¸ÀJÐPVÑWÔWÑˆ�Ø.8Ð.D˜Z¨œ]˜]È$ÐØ×ÒØ�AŒJ˜	 !œÐ&8¸+ñ	
ô 	
ð 	
ð?
ð ?
Ø26´,ð?
ñ ?
ô ?
Ðð Ô)Ð1Ý Ø^ñô ð ð
 +-ˆðg	I¥Gð g	I°ð g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	Ið g	IðT 	Ô×#Ò#Ñ%Ô%Ð%Ý!*¨4Ô+IÈ$Ì)Ô+TÑ!UÔ!Uð &	ñ &	ÑˆI�vÝ�LŠLØJØØñô ð ð
 Ý$Õ%@ÀÑ%HÔ%HÑIÔIð 0ð 0ØÔ.°$Ô2QÐQÐQÝ.Ø Ø#Ø%Ø&Ø"ñô ˜ð Q˜Ô7¸Ô8OÔPØ" Cñô ð ð ð  Ô0µKÒ?Ð?Ø!Ô-Ð5Ý"0Ð1JÑ"KÔ"KÐKØ%+Ô%7ð 3ð 3˜EØ+˜O¨EÑ2Ô2Ð2Ð2ð3ð (˜¨Ñ/Ô/Ð/ð%0ð 0ð 0ñ 0ô 0ð 0ð 0ð 0ð 0ð 0ð 0øøøð 0ð 0ð 0ð 0øøõ& ð ð ð Ý—’ØrØØñô ð õ
 —’Ý*ØÔ6Ø*3ðñ ô ñô ð ð �øøøøðøøøð ð 	,Ý˜HŸLšL™NœNÑ+Ô+Ð+ð ð 	,õ ˆtÔÑ Ô  AÒ%Ð%Ý Ð!<Ñ=Ô=Ð=ð 	×Ò˜DœL¨&Ñ1Ô1Ð1Ð1Ð1s>   Ã.F(Ä
BFÆF(ÆF 	Æ F(Æ#F 	Æ$F(Æ(
HÆ2AG>Ç>Hrq  )rQ  r8  )rA   rB   rC   ru  rÇ   r+   rv  r†  r:  rt   r¦   rM   r   r�  rI   rW  rM  r–  r   rš  r|   r   r  rv  rw  s   @r?   r{  r{  ¨  s#  ø€ € € € € ðð ð&ð &ð &ð &ð &ð %Là*ð%Lð 1ð%Lð 
ð	%Lð %Lð %Lð %LðT <Jð:Gð :Gà�c˜4 ¨$¡Ô/Ð/Ô0ð:Gð Ð7Ô8ð:Gð :Gð :Gð :Gð :Gð :Gð~ <JðGð GàðGð Ð7Ô8ðGð Gð Gð Gð Gð Gð8 <KðJð JàðJð Ð7Ô8ðJð Jð Jð Jð.
ð 
ð 
ðVÐ'9ð Vð Vð Vð Vð  $Ø!%Ø"&Ø"Ø#Ø-1ð~2ð ~2à˜‘ð~2ð ˜$‘;ð~2ð ˜4‘Kð	~2ð
 �t‘ð~2ð ð~2ð ˜#˜s˜(”^ dÑ*ð~2ð ~2ð ~2ð ~2ð ~2ð ~2ð ~2ð ~2rK   r{  c                   ó’   ‡ — e Zd ZdZ	 	 	 	 	 ddee         dedeez  dz  de	e
ef         ee         z  dz  d	ed
edefˆ fd„Zd„ Zˆ xZS )r&   ai  
    Breadth-First Pipeline Parallelism.
    See https://arxiv.org/abs/2211.05953 for details.
    Similar to Interleaved 1F1B, Looped BFS supports multiple stages per rank.
    What is different is that when microbatches are ready for multiple local
    stages, Loops BFS will prioritizes the earlier stage, running all available
    microbatches at once.
    NTFrÞ   r¶   r·   rº   r»   r  r}  c           	      ó  •— t          ¦   «                              |||||||¬¦  «         i | _        t          | j        ¦  «        D ]!}|                      |¦  «        }	|	| j        |<   Œ"|                      | j        ¦  «         d S )N)rÞ   r¶   r·   rº   r»   r  r}  )ra  rÇ   r€   r£   r•  Ú!_calculate_single_rank_operationsr�  )rV   rÞ   r¶   r·   rº   r»   r  r}  rª   Úrank_opsrÆ   s             €r?   rÇ   zScheduleLoopedBFS.__init__r
  s£   ø€ õ 	‰Œ×ÒØØ)ØØ/Ø#Ø'AØ'ð 	ñ 	
ô 	
ð 	
ð @BˆÔå˜$Ô,Ñ-Ô-ð 	1ð 	1ˆDØ×=Ò=¸dÑCÔCˆHØ(0ˆDÔ Ñ%Ð%ð 	×)Ò)¨$Ô*=Ñ>Ô>Ð>Ð>Ð>rK   c           	      ó  ‡— t          | j        ¦  «        }t          || j        |z  | j        ¦  «        }d„ t          |¦  «        D ¦   «         }|D ]5Š|                     ˆfd„t          | j        ¦  «        D ¦   «         ¦  «         Œ6d| j        dz
  |z
  z  }|                     d g|z  ¦  «         t          |¦  «        D ]BŠ|                     ˆfd„t          t          | j        ¦  «        ¦  «        D ¦   «         ¦  «         ŒC|S )Nc                 ó   — g | ]}d ‘ŒS rS   rJ   ©r[   r¤  s     r?   r]   zGScheduleLoopedBFS._calculate_single_rank_operations.<locals>.<listcomp>š
  ó   € Ð)DÐ)DÐ)D°1¨$Ð)DÐ)DÐ)DrK   c              3   óN   •K  — | ]}t          ‰t          j        |¦  «        V — Œ d S rS   )rM   r+   rD   ©r[   rÎ   rN   s     €r?   r…   zFScheduleLoopedBFS._calculate_single_rank_operations.<locals>.<genexpr>�
  sG   øè è € ð ð àõ ˜Õ%5Ô%=¸xÑHÔHðð ð ð ð ð rK   r–   r   c              3   óN   •K  — | ]}t          ‰t          j        |¦  «        V — Œ d S rS   )rM   r+   rG   r¶  s     €r?   r…   zFScheduleLoopedBFS._calculate_single_rank_operations.<locals>.<genexpr>¨
  sG   øè è € ð ð àõ ˜Õ%5Ô%CÀXÑNÔNðð ð ð ð ð rK   )ru   r!  r£   r•  rÝ   r½   rë   )rV   rª   Ún_local_stagesÚstage_indicesr°  Úpost_warmup_opsrN   s         @r?   r¯  z3ScheduleLoopedBFS._calculate_single_rank_operations’
  sN  ø€ Ý˜Tœ\Ñ*Ô*ˆÝØ�$Ô$ ~Ñ5°tÔ7Iñ
ô 
ˆð *EÐ)D½¸d¹¼Ð)DÑ)DÔ)Dˆà(ð 	ð 	ˆKØ�OŠOð ð ð ð å % dÔ&:Ñ ;Ô ;ðñ ô ñ ô ð ð ð ˜tÔ1°AÑ5¸Ñ<Ñ=ˆØ�Š˜˜ Ñ0Ñ1Ô1Ð1å# MÑ2Ô2ð 	ð 	ˆKØ�OŠOð ð ð ð å (­¨tÔ/CÑ)DÔ)DÑ EÔ Eðñ ô ñ ô ð ð ð ˆrK   )NNTTF)rA   rB   rC   ru  r¦   r   rt   r   r   r:  rI   r   rp   r|   rÇ   r¯  rv  rw  s   @r?   r&   r&   h
  s×   ø€ € € € € ðð ð ,0Ø@DØ Ø+/Ø#ð?ð ?àÐ'Ô(ð?ð ð?ð ˜EÑ! DÑ(ð	?ð
    S œ>¨E°#¬JÑ6¸Ñ=ð?ð ð?ð %)ð?ð ð?ð ?ð ?ð ?ð ?ð ?ð@ð ð ð ð ð ð rK   r&   Fc
                 óê  — t          t          ¦  «        }
t          t          ¦  «        }t          t          ¦  «        }d„ t          |¦  «        D ¦   «         }| |z  d|dz
  |z
  z  z   ||z   z
  }|	r||z
  dz
  }||z   |z   }g }d}|	rt          nt          }t          |¦  «        D �]Q}||k     rl ||¦  «        }|
|         x}dz   |
|<   |                     t          |t          j        |¦  «        ¦  «         ||dz
  k    r| 	                    d g|z  ¦  «         Œu||cxk    r
||z   k     �rn nþ ||¦  «        }|
|         x}dz   |
|<   |                     t          |t          j        |¦  «        ¦  «          ||¦  «        }||         x}dz   ||<   |                     t          |||¦  «        ¦  «         |                     |¦  «         |	r]||z
  |k    rT |||         ¦  «        }||         x}dz   ||<   |                     t          |t          j
        |¦  «        ¦  «         |dz  }�Œ‡|	s|                     d ¦  «          ||¦  «        }||         x}dz   ||<   |                     t          |||¦  «        ¦  «         |                     |¦  «         |	r]||z
  |k    rT |||         ¦  «        }||         x}dz   ||<   |                     t          |t          j
        |¦  «        ¦  «         |dz  }�ŒS|	r||t          |¦  «        k     ri |||         ¦  «        }||         x}dz   ||<   |                     t          |t          j
        |¦  «        ¦  «         |dz  }|	r|t          |¦  «        k     °i|S )Nc                 ó   — g | ]}d ‘ŒS rS   rJ   r³  s     r?   r]   z&_get_1f1b_rank_ops.<locals>.<listcomp>Â
  s   € Ð%@Ð%@Ð%@¨q dÐ%@Ð%@Ð%@rK   r–   r   r   )r   rt   r£   rE   rG   ro   rM   r+   rD   rÝ   rF   ru   )r¸  r•  Ú
warmup_opsÚfwd_bwd_opsÚcooldown_opsrª   Úforward_stage_indexÚbackward_stage_indexÚnum_1f1b_microbatchesÚenable_zero_bubbleÚfwd_stage_mb_indexÚbwd_stage_mb_indexÚweight_stage_mb_indexr°  rº  Ú	total_opsÚbackward_op_idsÚweight_op_countÚFULL_BACKWARD_OR_BACKWARD_INPUTr?  Úfwd_stage_indexrÎ   r   Úbwd_stage_indexr¡  Úweight_stage_indexÚweight_mb_indexs                              r?   Ú_get_1f1b_rank_opsrÏ  ¯
  s¨  € õ *5µSÑ)9Ô)9ÐÝ)4µSÑ)9Ô)9ÐÝ,7½Ñ,<Ô,<Ðð &AÐ%@µE¸$±K´KÐ%@Ñ%@Ô%@€Hð 	˜Ñ&¨¨m¸aÑ.?À$Ñ.FÑ)GÑGØ	�dÑ	ñ€Oð ð 3Ø'¨$Ñ.°Ñ2ˆà˜[Ñ(¨<Ñ7€Ià€OØ€Oð -Ð?�ˆµ-ð $õ �IÑÔð M%ñ M%ˆà�
Š?ˆ?Ø1Ð1°"Ñ5Ô5ˆOð /¨Ô?Ð?�Øñ3Ð˜Ñ/ð �OŠOÝ˜Õ)9Ô)AÀ8ÑLÔLñô ð ð �Z !‘^Ò#Ð#à—’  ¨Ñ 8Ñ9Ô9Ð9øà˜2Ð8Ð8Ò8Ð8 
¨[Ñ 8Ò8Ñ8Ð8Ð8Ð8Ø1Ð1°"Ñ5Ô5ˆOà 2°?Ô CÐC�Øñ3Ð˜Ñ/ð �OŠOÝ˜Õ)9Ô)AÀ<ÑPÔPñô ð ð 3Ð2°2Ñ6Ô6ˆOà 2°?Ô CÐC�Øñ3Ð˜Ñ/ð �OŠOÝ˜Ð)HÈ,ÑWÔWñô ð ð ×"Ò" 2Ñ&Ô&Ð&à!ð % b¨:¡oÐ9NÒ&NÐ&NØ%9Ð%9Ø# OÔ4ñ&ô &Ð"ð (=Ð=OÔ'PÐP�OØñ=Ð%Ð&8Ñ9ð —’ÝØ*Ý(Ô8Ø'ñô ñô ð ð   1Ñ$�ùð
 &ð &Ø—’ Ñ%Ô%Ð%à2Ð2°2Ñ6Ô6ˆOà 2°?Ô CÐC�Øñ3Ð˜Ñ/ð �OŠOÝ˜Ð)HÈ,ÑWÔWñô ð ð ×"Ò" 2Ñ&Ô&Ð&à!ð % b¨:¡oÐ9NÒ&NÐ&NØ%9Ð%9Ø# OÔ4ñ&ô &Ð"ð (=Ð=OÔ'PÐP�OØñ=Ð%Ð&8Ñ9ð —’ÝØ*Ý(Ô8Ø'ñô ñô ð ð   1Ñ$�ùà
ð 
 µ3°Ñ3GÔ3GÒ!GÐ!GØ1Ð1°/À/Ô2RÑSÔSÐà4Ð5GÔHÐHˆOØñ5ÐÐ0Ñ1ð 	�ŠÝØ"Õ$4Ô$DÀoñô ñ	
ô 	
ð 	
ð
 	˜1Ñˆð ð 
 µ3°Ñ3GÔ3GÒ!GÐ!Gð €OrK   r–   rª   r¸  Úmicrobatches_per_roundÚmultiply_factorc                 óT   — |dz
  |z  }|||dz
  | z
  z  z   }t          |||z  ¦  «        S )zN
    Calculate the number of warmup operations for interleaved schedules.
    r   )rž  )rª   r¸  rÐ  r•  r¶   rÑ  Úwarmups_ops_last_stager½  s           r?   Ú_get_warmup_opsrÔ  8  sD   € ð -¨qÑ0Ð4JÑJÐà'¨/¸mÈaÑ>OÐSWÑ=WÑ*XÑX€Jåˆz˜>¨NÑ:Ñ;Ô;Ð;rK   c                   óÜ   ‡ — e Zd ZdZ	 	 	 	 	 	 	 ddee         dededz  dee	d	f         dz  d
e
ee	f         dz  de
eef         ee         z  dz  dededefˆ fd„Zdeedz           fd„Zˆ xZS )r%   a…  
    The Interleaved 1F1B schedule.
    See https://arxiv.org/pdf/2104.04473 for details.
    Will perform one forward and one backward on the microbatches in steady
    state and supports multiple stages per rank. When microbatches are ready for
    multiple local stages, Interleaved 1F1B prioritizes the earlier microbatch
    (also called "depth first").

    This schedule is mostly similar to the original paper.
    It differs by being relaxing the requirement of num_microbatch % pp_size == 0.
    Using the flex_pp schedule, we will have num_rounds = max(1, n_microbatches // pp_group_size) and
    it works as long as n_microbatches % num_rounds is 0. As a few examples, support

    1. pp_group_size = 4, n_microbatches = 10. We will have num_rounds = 2 and n_microbatches % 2 is 0.
    2. pp_group_size = 4, n_microbatches = 3. We will have num_rounds = 1 and n_microbatches % 1 is 0.
    NTFrÞ   r¶   r·   r¸   .r¹   rº   r»   r  r}  c
                 ó$  •— |d         j         | _        t          ¦   «                              |||||||||	¬¦	  «	         t	          |¦  «        | _        |d         j        | _        t          d|| j        z  ¦  «        | _	        || j	        z  | _
        || j	        z  dk    rt          d| j	        › d|› d�¦  «        ‚i | _        t          | j        ¦  «        D ]!}
|                      |
¦  «        }|| j        |
<   Œ"|                      | j        ¦  «         d S )Nr   ©	rÞ   r¶   r·   r¸   r¹   rº   r»   r  r}  r   z_Interleaved 1F1B requires the number of microbatches to be a multiple of the number of rounds (ú), but got ú.)r"  r•  ra  rÇ   ru   r¸  r#  rª   r“   Únumber_of_roundsrÐ  r<   r€   r£   r¯  r�  ©rV   rÞ   r¶   r·   r¸   r¹   rº   r»   r  r}  rª   r°  rÆ   s               €r?   rÇ   z ScheduleInterleaved1F1B.__init__]  sL  ø€ ð $ AœYÔ1ˆÔÝ‰Œ×ÒØØ)ØØ+Ø/Ø/Ø#Ø'AØ'ð 	ñ 
	
ô 
	
ð 
	
õ " &™kœkˆÔØ˜1”IÔ(ˆŒ	Ý # A ~¸Ô9KÑ'KÑ LÔ LˆÔØ&4¸Ô8MÑ&MˆÔ#Ø˜DÔ1Ñ1°QÒ6Ð6Ýð-Ø59Ô5Jð-ð -à)ð-ð -ð -ñô ð ð @BˆÔÝ˜$Ô,Ñ-Ô-ð 	1ð 	1ˆDØ×=Ò=¸dÑCÔCˆHØ(0ˆDÔ Ñ%Ð%ð 	×)Ò)¨$Ô*=Ñ>Ô>Ð>Ð>Ð>rK   r9   c           
      ó4  ‡ ‡‡— t          ‰‰ j        ‰ j        ‰ j        ‰ j        d¬¦  «        Š‰ j        ‰ j        z  }|‰z
  }||z
  }‰|z   |z   }t
                               d‰‰|||¦  «         ˆˆ fd„}ˆˆ ˆfd„}t          ‰ j        ‰ j        ‰||‰||¦  «        S )Nr–   ©rÑ  ú=rank %s, warmup_ops %s, 1f1b %s, cooldown_ops %s total_ops %sc                 óB   •— | ‰j         z  ‰j        z  }|‰j        z  ‰z   S rS   ©rÐ  r¸  r•  ©r#  Úlocal_indexrª   rV   s     €€r?   rÀ  zVScheduleInterleaved1F1B._calculate_single_rank_operations.<locals>.forward_stage_index¥  ó+   ø€ à 4Ô#>Ñ>À$ÔBUÑUˆKØ $Ô"4Ñ4¸Ñ<Ð<rK   c                 ó^   •— ‰j         dz
  | ‰z
  ‰j        z  ‰j         z  z
  }|‰j        z  ‰z   S r´  ©r¸  rÐ  r•  ©r#  râ  rª   rV   r½  s     €€€r?   rÁ  zWScheduleInterleaved1F1B._calculate_single_rank_operations.<locals>.backward_stage_indexª  óK   ø€ àÔ#Øñà˜:Ñ%¨$Ô*EÑEØÔ%ñ&ñ&ð ð   $Ô"4Ñ4¸Ñ<Ð<rK   ©rÔ  r¸  rÐ  r•  r½   rÄ   rð   rÏ  )	rV   rª   Úmicrobatch_opsr¾  r¿  rÇ  rÀ  rÁ  r½  s	   ``      @r?   r¯  z9ScheduleInterleaved1F1B._calculate_single_rank_operationsŠ  s  øøø€ Ý$ØØÔØÔ'ØÔØÔ Øð
ñ 
ô 
ˆ
ð Ô,¨tÔ/CÑCˆà$ zÑ1ˆà%¨Ñ3ˆà Ñ,¨|Ñ;ˆ	å�ŠØKØØØØØñ	
ô 	
ð 	
ð	=ð 	=ð 	=ð 	=ð 	=ð 	=ð
	=ð 	=ð 	=ð 	=ð 	=ð 	=ð 	=õ "ØÔØÔØØØØØØ ñ	
ô 	
ð 		
rK   ©NNNNTTF©rA   rB   rC   ru  r¦   r   rt   r   rp   r   r:  rI   r   r|   rÇ   rM   r¯  rv  rw  s   @r?   r%   r%   K  s  ø€ € € € € ðð ð* $(Ø>BØ?CØ@DØ Ø+/Ø#ð+?ð +?àÐ'Ô(ð+?ð ð+?ð ˜D‘ð	+?ð
 ˜°Ð3Ô4°tÑ;ð+?ð    _Ð 4Ô5¸Ñ<ð+?ð    S œ>¨E°#¬JÑ6¸Ñ=ð+?ð ð+?ð %)ð+?ð ð+?ð +?ð +?ð +?ð +?ð +?ðZ2
¸¸gÈ¹nÔ9Mð 2
ð 2
ð 2
ð 2
ð 2
ð 2
ð 2
ð 2
rK   r%   c                   óâ   ‡ — e Zd ZdZ	 	 	 	 	 	 	 ddee         dededz  dee	d	f         dz  d
e
ee	f         dz  de
eef         ee         z  dz  dededefˆ fd„Zdeedz           fd„Zd„ Zˆ xZS )r'   aw  
    The Interleaved Zero Bubble schedule.
    See https://arxiv.org/pdf/2401.10241 for details.
    Will perform one forward and one backward on inputs for the microbatches in steady
    state and supports multiple stages per rank. Uses the backward for weights to fill in
    the pipeline bubble.

    In particular this is implementing the ZB1P schedule in the paper.
    NTFrÞ   r¶   r·   r¸   .r¹   rº   r»   r  r}  c
                 ó¦  •— t          || j        j        ¦  «         |d         j        | _        t          ¦   «                              |||||||||	¬¦	  «	         t          |¦  «        | _        |d         j	        | _
        t          d|| j        z  ¦  «        | _        || j        z  | _        || j        z  dk    rt          d| j        › d|› d�¦  «        ‚i | _        t!          | j        ¦  «        D ]!}
|                      |
¦  «        }|| j        |
<   Œ"|                      | j        | j        z  ¦  «        | _        |                      | j        ¦  «         d S )Nr   r×  r   zZZero bubble requires the number of microbatches to be a multiple of the number of rounds (rØ  rÙ  )Ú"_check_torch_compile_compatibilityrÆ   rA   r"  r•  ra  rÇ   ru   r¸  r#  rª   r“   rÚ  rÐ  r<   r€   r£   r¯  Ú_add_bubbles_to_actionsr�  rÛ  s               €r?   rÇ   z&ScheduleInterleavedZeroBubble.__init__Ê  s‰  ø€ õ 	+¨6°4´>Ô3JÑKÔKÐKØ# AœYÔ1ˆÔÝ‰Œ×ÒØØ)ØØ+Ø/Ø/Ø#Ø'AØ'ð 	ñ 
	
ô 
	
ð 
	
õ " &™kœkˆÔØ˜1”IÔ(ˆŒ	Ý # A ~¸Ô9KÑ'KÑ LÔ LˆÔØ&4¸Ô8MÑ&MˆÔ#Ø˜DÔ1Ñ1°QÒ6Ð6Ýð-Ø59Ô5Jð-ð -à)ð-ð -ð -ñô ð ð @BˆÔÝ˜$Ô,Ñ-Ô-ð 	1ð 	1ˆDØ×=Ò=¸dÑCÔCˆHØ(0ˆDÔ Ñ%Ð%ð
 #×:Ò:ØÔ $Ô"4Ñ4ñ
ô 
ˆÔð
 	×)Ò)¨$Ô*=Ñ>Ô>Ð>Ð>Ð>rK   r9   c                 ó>  ‡ ‡‡	— t          ‰‰ j        ‰ j        ‰ j        ‰ j        d¬¦  «        Š	‰ j        ‰ j        z  }|‰	z
  }||z
  }‰	|z   |z   }t
                               d‰‰	|||¦  «         ˆˆ fd„}ˆˆ ˆ	fd„}‰}t          ‰ j        ‰ j        ‰	||‰|||d¬¦
  «
        S )Nr   rÝ  rÞ  c                 óB   •— | ‰j         z  ‰j        z  }|‰j        z  ‰z   S rS   rà  rá  s     €€r?   rÀ  z\ScheduleInterleavedZeroBubble._calculate_single_rank_operations.<locals>.forward_stage_index  rã  rK   c                 ó^   •— ‰j         dz
  | ‰z
  ‰j        z  ‰j         z  z
  }|‰j        z  ‰z   S r´  rå  ræ  s     €€€r?   rÁ  z]ScheduleInterleavedZeroBubble._calculate_single_rank_operations.<locals>.backward_stage_index!  rç  rK   T)rÃ  rè  )
rV   rª   ré  r¾  r¿  rÇ  rÀ  rÁ  rÂ  r½  s
   ``       @r?   r¯  z?ScheduleInterleavedZeroBubble._calculate_single_rank_operations   s  øøø€ Ý$ØØÔØÔ'ØÔØÔ Øð
ñ 
ô 
ˆ
ð Ô,¨tÔ/CÑCˆà$ zÑ1ˆà%¨Ñ3ˆà Ñ,¨|Ñ;ˆ	å�ŠØKØØØØØñ	
ô 	
ð 	
ð	=ð 	=ð 	=ð 	=ð 	=ð 	=ð
	=ð 	=ð 	=ð 	=ð 	=ð 	=ð 	=ð !%Ðå!ØÔØÔØØØØØØ Ø!Ø#ð
ñ 
ô 
ð 	
rK   c                 óž  — | j         }d„ }t          ¦   «         }i }i }i }d}t          | j        ¦  «        D ]}	g ||	<   d||	<   d||	<   Œ	 d}
t          ¦   «         }t          | j        ¦  «        D �]#}	||	         }|t	          ||	         ¦  «        k    rŒ%d}
||	         |         �Ã||	         |         }|€t          dt          |¦  «        › �¦  «        ‚|\  }}}} ||||||¦  «        sR||	                              ||	         |         ¦  «         |�|                     |||f¦  «         ||	xx         dz  cc<   ŒÌ||	                              d ¦  «         ||	xx         dz  cc<   Œø||	xx         dz  cc<   ||	                              d ¦  «         �Œ%| 	                    |¦  «         |
rn�Œc|dk    rt                               d||¦  «         |S )Nc                 ó´   — |t           j        k    r| dk    r| dz
  ||f|vrdS n4|t           j        k    r$| |dz
  k    r| t           j        |f|vS | dz   ||f|vS dS )Nr   r   TF)r+   rD   rG   )rË   r?  Ú
microbatchÚnum_stages_globalÚseen_opss        r?   Úneed_bubblezJScheduleInterleavedZeroBubble._add_bubbles_to_actions.<locals>.need_bubble<  s‡   € ØÕ%Ô-Ò-Ð-Ø˜A’:�: 5¨1¡9¨b°*Ð"=ÀXÐ"MÐ"MØ˜4øØÕ'Ô5Ò5Ð5ØÐ-°Ñ1Ò1Ð1Ø!Õ#3Ô#;¸ZÐHÐPXÐXÐXØ ™	 2 zÐ2¸(ÐBÐBØ�5rK   r   TFz)Expected temp_action to be not None, got r   z?Non zero bubbles added: total_bubbles_added=%s bubbles_added=%s)r€   rÂ  r£   r•  ru   r  r  ro   rÃ  ÚupdaterÄ   r)  )rV   rö  r„   rø  r÷  rõ   Únext_pointerÚbubbles_addedÚtotal_bubbles_addedrª   Úshould_stopÚtemp_seen_opsÚ	timestampÚtemp_actionrN   r?  rõ  r¤  s                     r?   rï  z5ScheduleInterleavedZeroBubble._add_bubbles_to_actions9  sj  € ØÔ%ˆð	ð 	ð 	õ <?¹5¼5ˆØ24ˆØ')ˆØ(*ˆØÐå˜$Ô,Ñ-Ô-ð 	$ð 	$ˆDØˆF�4‰LØ!"ˆL˜ÑØ"#ˆM˜$ÑÐð#	ØˆKåDGÁEÄEˆMå˜dÔ0Ñ1Ô1ð .ñ .�Ø(¨Ô.�	Ø¥ G¨D¤MÑ 2Ô 2Ò2Ð2Øà#�à˜4”= Ô+Ð7Ø")¨$¤-°	Ô":�KØ"Ð*Ý,Ø[ÍÈ[ÑHYÔHYÐ[Ð[ñô ð ð 6AÑ2�K  Z°Ø&˜;Ø# R¨Ð5FÈñô ð 	1ð ˜tœ×+Ò+¨G°D¬M¸)Ô,DÑEÔEÐEØ%Ð1Ø)×-Ò-¨{¸BÀ
Ð.KÑLÔLÐLØ$ TÐ*Ð*Ô*¨aÑ/Ð*Ð*Ñ*Ð*à˜tœ×+Ò+¨DÑ1Ô1Ð1Ø% dÐ+Ð+Ô+¨qÑ0Ð+Ð+Ñ+Ð+à  Ð&Ð&Ô&¨!Ñ+Ð&Ð&Ñ&Ø˜4”L×'Ò'¨Ñ-Ô-Ð-Ñ-à�OŠO˜MÑ*Ô*Ð*Øð ØñG#	ðJ  Ò"Ð"Ý�NŠNØQØ#Øñô ð ð
 ˆrK   rê  )rA   rB   rC   ru  r¦   r   rt   r   rp   r   r:  rI   r   r|   rÇ   rM   r¯  rï  rv  rw  s   @r?   r'   r'   ¿  s5  ø€ € € € € ðð ð $(Ø>BØ?CØ@DØ Ø+/Ø#ð4?ð 4?àÐ'Ô(ð4?ð ð4?ð ˜D‘ð	4?ð
 ˜°Ð3Ô4°tÑ;ð4?ð    _Ð 4Ô5¸Ñ<ð4?ð    S œ>¨E°#¬JÑ6¸Ñ=ð4?ð ð4?ð %)ð4?ð ð4?ð 4?ð 4?ð 4?ð 4?ð 4?ðl7
¸¸gÈ¹nÔ9Mð 7
ð 7
ð 7
ð 7
ðrCð Cð Cð Cð Cð Cð CrK   r'   c                   óÜ   ‡ — e Zd ZdZ	 	 	 	 	 	 	 ddee         dededz  dee	d	f         dz  d
e
ee	f         dz  de
eef         ee         z  dz  dededefˆ fd„Zdeedz           fd„Zˆ xZS )r(   a£  
    The Zero Bubble schedule (ZBV variant).
    See https://arxiv.org/pdf/2401.10241 Section 6 for details.

    This schedules requires exactly two stages per rank.

    This schedule will perform one forward and one backward on inputs for the microbatches in steady
    state and supports multiple stages per rank. Uses backward with respect to weights to fill in
    the pipeline bubble.

    This ZB-V schedule would have the "zero bubble" property only if time forward == time backward input == time backward weights.
    In practice, this is not likely true for real models so alternatively
    a greedy scheduler could be implemented for unequal/unbalanced time.
    NTFrÞ   r¶   r·   r¸   .r¹   rº   r»   r  r}  c
                 ó†  •— t          || j        j        ¦  «         |d         j        | _        t          ¦   «                              |||||||||	¬¦	  «	         t          | j        | j        d¬¦  «        | _	        | j
        D ]}
| j	        |
_	        Œt          |¦  «        | _        | j        dk    rt          d| j        › d�¦  «        ‚|d         j        | _        |d         j        | _        i | _        t%          | j        ¦  «        D ]!}|                      |¦  «        }|| j        |<   Œ"|                      | j        ¦  «         d S )Nr   r×  rþ  ©Ústyler–   ú0ZBV requires exactly 2 stages per rank, but got rÙ  ©rî  rÆ   rA   r"  r•  ra  rÇ   r   rd  r$  r!  ru   r¸  r<   r#  rª   rc  r€   r£   r¯  r�  ©rV   rÞ   r¶   r·   r¸   r¹   rº   r»   r  r}  rË   rª   r°  rÆ   s                €r?   rÇ   zScheduleZBVZeroBubble.__init__�  s}  ø€ õ 	+¨6°4´>Ô3JÑKÔKÐKØ# AœYÔ1ˆÔÝ‰Œ×ÒØØ)ØØ+Ø/Ø/Ø#Ø'AØ'ð 	ñ 
	
ô 
	
ð 
	
õ *HØÔ Ô 0¸ð*
ñ *
ô *
ˆÔ&ð ”\ð 	Mð 	MˆEØ.2Ô.LˆEÔ+Ð+å! &™kœkˆÔØÔ !Ò#Ð#Ýð*ØÔ&ð*ð *ð *ñô ð ð
 ˜1”IÔ(ˆŒ	Ø  œ)Ô.ˆŒð
 @BˆÔÝ˜$Ô,Ñ-Ô-ð 	1ð 	1ˆDØ×=Ò=¸dÑCÔCˆHØ(0ˆDÔ Ñ%Ð%ð 	×)Ò)¨$Ô*=Ñ>Ô>Ð>Ð>Ð>rK   r9   c                 óN	  ‡ — t          d‰ j        z  dz
  ‰ j        ¦  «        }d„ t          |¦  «        D ¦   «         }d\  }}}}d‰ j        |z
  z  dz
  }|}	‰ j        dz
  |z
  }
t          |¦  «        D ]1}|                     t          |	t          |¬¦  «        ¦  «         |dz  }Œ2|}t          |¦  «        D ]`}|                     t          |
t          |¬¦  «        ¦  «         |dz  }|                     t          |	t          |¬¦  «        ¦  «         |dz  }Œa‰ j        |z
  }t          |¦  «        D ]Š}|                     t          |
t          |¬¦  «        ¦  «         |dz  }|                     t          |
t          |¬¦  «        ¦  «         |                     t          |
t          |¬¦  «        ¦  «         |dz  }Œ‹||k     s||k     �r$||k     r/|                     t          |	t          |¬¦  «        ¦  «         |dz  }|                     t          |	t          |¬¦  «        ¦  «         |                     t          |	t          |¬¦  «        ¦  «         |dz  }|                     t          |
t          |¬¦  «        ¦  «         |dz  }|                     t          |
t          |¬¦  «        ¦  «         |                     t          |
t          |¬¦  «        ¦  «         |dz  }||k     �°||k     �°$||}}|}t          |¦  «        D ]`}|                     t          |	t          |¬¦  «        ¦  «         |dz  }|                     t          |
t          |¬¦  «        ¦  «         |dz  }Œa‰ j        |z
  }t          |¦  «        D ]`}|                     t          |	t          |¬¦  «        ¦  «         |dz  }|                     t          |	t          |¬¦  «        ¦  «         |dz  }Œa||k     r5|                     t          |
t          |¬¦  «        ¦  «         |dz  }||k     °5||k     r5|                     t          |	t          |¬¦  «        ¦  «         |dz  }||k     °5||k    r||k    st          d|› d|› d|› �¦  «        ‚||k    r||k    st          d	|› d
|› d|› �¦  «        ‚ˆ fd„|D ¦   «         }|S )Nr–   r   c                 ó   — g | ]}d ‘ŒS rS   rJ   r³  s     r?   r]   zKScheduleZBVZeroBubble._calculate_single_rank_operations.<locals>.<listcomp>È  r´  rK   )r   r   r   r   )rO   rP   z0Expected w0_cnt == b0_cnt == f0_cnt, got w0_cnt=z	, b0_cnt=z	, f0_cnt=z0Expected w1_cnt == b1_cnt == f1_cnt, got w1_cnt=z	, b1_cnt=z	, f1_cnt=c                 óJ   •— g | ]}|�|j         �|j         ‰j        k     r|nd ‘Œ S rS   )rP   r½   )r[   r8   rV   s     €r?   r]   zKScheduleZBVZeroBubble._calculate_single_rank_operations.<locals>.<listcomp>4  sT   ø€ ð 	
ð 	
ð 	
ð ð Ð%ØÔ+Ð7ØÔ+¨dÔ.BÒBÐBð �ð ð	
ð 	
ð 	
rK   )r“   r•  r½   r£   rc  ro   rM   r,   r-   r.   r  )rV   rª   Ún_micror°  Úf0_cntÚf1_cntÚb0_cntÚb1_cntÚ	warmup_n1Ústage_id_chunk0Ústage_id_chunk1r¤  Ú	warmup_n2Ú	warmup_n3Úw0_cntÚw1_cntÚcooldown_n1Úcooldown_n2s   `                 r?   r¯  z7ScheduleZBVZeroBubble._calculate_single_rank_operationsÄ  sÂ  ø€ õ �a˜$Ô,Ñ,¨qÑ0°$Ô2FÑGÔGˆØ)DÐ)D½¸d¹¼Ð)DÑ)DÔ)Dˆð *4Ñ&ˆ�˜ à˜Ô+¨dÑ2Ñ3°aÑ7ˆ	ØˆØœ/¨AÑ-°Ñ4ˆå�yÑ!Ô!ð 	ð 	ˆAØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFˆFØˆ	Ý�yÑ!Ô!ð 	ð 	ˆAØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFˆFØÔ&¨Ñ-ˆ	Ý�yÑ!Ô!ð 	ð 	ˆAØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFˆFà�vŠoˆo ¨'Ò!1Ñ!1Ø˜ÒÐØ—’ÝØ'½!Èfðñ ô ñô ð ð
 ˜!‘�Ø�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFà�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFð5 �vŠo‰o ¨'Ò!1Ñ!1ð8   �ˆØˆÝ�{Ñ#Ô#ð 	ð 	ˆAØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFˆFØÔ(¨4Ñ/ˆÝ�{Ñ#Ô#ð 	ð 	ˆAØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFˆFØ�vŠoˆoØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFð	 �vŠoˆoð
 �vŠoˆoØ�OŠOÝ˜½!ÈfÐUÑUÔUñô ð ð �a‰KˆFð	 �vŠoˆoð ˜&Ò Ð  V¨vÒ%5Ð%5Ý ØmÀ6ÐmÐmÐTZÐmÐmÐekÐmÐmñô ð ð ˜&Ò Ð  V¨vÒ%5Ð%5Ý ØmÀ6ÐmÐmÐTZÐmÐmÐekÐmÐmñô ð ð
	
ð 	
ð 	
ð 	
ð #ð	
ñ 	
ô 	
ˆð ˆrK   rê  rë  rw  s   @r?   r(   r(     s'  ø€ € € € € ðð ð& $(Ø>BØ?CØ@DØ Ø+/Ø#ð3?ð 3?àÐ'Ô(ð3?ð ð3?ð ˜D‘ð	3?ð
 ˜°Ð3Ô4°tÑ;ð3?ð    _Ð 4Ô5¸Ñ<ð3?ð    S œ>¨E°#¬JÑ6¸Ñ=ð3?ð ð3?ð %)ð3?ð ð3?ð 3?ð 3?ð 3?ð 3?ð 3?ðjz¸¸gÈ¹nÔ9Mð zð zð zð zð zð zð zð zrK   r(   c                   óÜ   ‡ — e Zd ZdZ	 	 	 	 	 	 	 ddee         dededz  dee	d	f         dz  d
e
ee	f         dz  de
eef         ee         z  dz  dededefˆ fd„Zdeedz           fd„Zˆ xZS )r)   zò
    The DualPipeV schedule. A more efficient schedule variant based on the
    DualPipe schedule introduced by DeepSeek in https://arxiv.org/pdf/2412.19437

    Based on the open sourced code from https://github.com/deepseek-ai/DualPipe
    NTFrÞ   r¶   r·   r¸   .r¹   rº   r»   r  r}  c
                 óÒ  •— t          || j        j        ¦  «         |d         j        | _        t          ¦   «                              |||||||||	¬¦	  «	         t          | j        | j        d¬¦  «        | _	        | j
        D ]}
| j	        |
_	        Œt          |¦  «        | _        | j        dk    rt          d| j        › d�¦  «        ‚|| j        k     rt          d|› d	| j        › d
�¦  «        ‚|d         j        | _        |d         j        | _        i | _        t%          | j        ¦  «        D ]!}|                      |¦  «        }|| j        |<   Œ"|                      | j        ¦  «         d S )Nr   r×  rþ  r  r–   r  rÙ  zDDualPipeV requires at least as many microbatches as stages, but got z microbatches and z stages.r  r  s                €r?   rÇ   zScheduleDualPipeV.__init__I  sÌ  ø€ õ 	+¨6°4´>Ô3JÑKÔKÐKØ# AœYÔ1ˆÔÝ‰Œ×ÒØØ)ØØ+Ø/Ø/Ø#Ø'AØ'ð 	ñ 
	
ô 
	
ð 
	
õ *HØÔ Ô 0¸ð*
ñ *
ô *
ˆÔ&ð ”\ð 	Mð 	MˆEØ.2Ô.LˆEÔ+Ð+å! &™kœkˆÔØÔ !Ò#Ð#Ýð*ØÔ&ð*ð *ð *ñô ð ð ˜DÔ,Ò,Ð,ÝðPØ!ðPð PØ59Ô5EðPð Pð Pñô ð ð
 ˜1”IÔ(ˆŒ	Ø  œ)Ô.ˆŒð
 @BˆÔÝ˜$Ô,Ñ-Ô-ð 	1ð 	1ˆDØ×=Ò=¸dÑCÔCˆHØ(0ˆDÔ Ñ%Ð%ð 	×)Ò)¨$Ô*=Ñ>Ô>Ð>Ð>Ð>rK   r9   c                 ó”  ‡‡‡— g }i Šg Š| j         }| j        }t          ||dz  d¬¦  «        }||         \  }}dt          fˆfd„Šdt          dt          dt          fˆˆfd	„}dt          dt          d
t
          fˆˆˆfd„}	dt          fˆˆfd„}
||z
  dz
  dz  }t          |¦  «        D ]} |	||t          ¦  «         Œ|dz   }t          |¦  «        D ]&} |	||t          ¦  «          |	||t          ¦  «         Œ'||z
  dz
  }t          |¦  «        D ]1} |	||t          ¦  «          |
|¦  «          |	||t          ¦  «         Œ2||dz  z
  |z   dz   }t          |¦  «        D ]R}|dk    r.||dz
  k    r% |	||t          ¦  «          |	||t          ¦  «         n ||||¬¦  «          ||||¬¦  «         ŒS||z
  dz
  }t          |¦  «        D ]"} |	||t          ¦  «          ||||¬¦  «         Œ#|dz   }d}t          |¦  «        D ]d}||dz  k    r|dz  dk    rd}|rt          nt          } |	|||¦  «         ||dz  k    r|dz  dk    rd}|rt          nt          } |	|||¦  «         Œe||z
  dz
  }t          |¦  «        D ]*} |
|¦  «         |rt          nt          } |	|||¦  «         Œ+|dz   }t          |¦  «        D ]} |
|¦  «         Œ|S )Nr–   rþ  r  rN   c                 óœ   •— | t           f}| t          f}‰                     |d¦  «        dz   ‰|<   ‰                     |d¦  «        dz   ‰|<   dS )zbHelper method to increment BACKWARD_INPUT and BACKWARD_WEIGHT counters when FULL_BACKWARD is used.r   r   N)rE   rF   r‹   )rN   Ú	input_keyÚ
weight_keyÚcounterss      €r?   Úincrement_backward_countszVScheduleDualPipeV._calculate_single_rank_operations.<locals>.increment_backward_counts’  sW   ø€ à$¥nÐ5ˆIØ%¥Ð7ˆJØ"*§,¢,¨y¸!Ñ"<Ô"<¸qÑ"@ˆH�YÑØ#+§<¢<°
¸AÑ#>Ô#>ÀÑ#BˆH�ZÑ Ð Ð rK   r„   Úforward_stageÚbackward_stagec                 óV  •— |t           f}|t          f}‰                     |d¦  «        }‰                     |d¦  «        }t          |t           |¦  «        t          |t          |¦  «        f}|                      t          dt          d|¦  «        ¦  «         |dz   ‰|<    ‰	|¦  «         dS )zYHelper method to add an overlapped forward+backward action which tracks microbatch index.r   rj   Nr   )rD   rE   r‹   rM   rG   ro   r6   )
r„   r!  r"  Úforward_keyÚbackward_keyrª  r¬  rQ   r  r   s
           €€r?   Úadd_overlap_f_bzLScheduleDualPipeV._calculate_single_rank_operations.<locals>.add_overlap_f_b™  s¯   ø€ ð )­'Ð2ˆKØ*­NÐ;ˆLà!Ÿš k°1Ñ5Ô5ˆJØ"Ÿ,š, |°QÑ7Ô7ˆKõ ˜¥w°
Ñ;Ô;Ý˜­°{ÑCÔCðˆKð �NŠN�7 2¥{°D¸+ÑFÔFÑGÔGÐGð %/°¡NˆH�[Ñ!Ø%Ð% nÑ5Ô5Ð5Ð5Ð5rK   rO   c                 ó0  •— |t           k    r||fn|t          f}‰                     |d¦  «        }|                      t	          |||¦  «        ¦  «         |t           k    r ‰|¦  «         d S |t          k    r‰                     ||f¦  «         |dz   ‰|<   d S )Nr   r   )rG   rE   r‹   ro   rM   )r„   rN   rO   rŒ   rÎ   r  r   Úweight_queues        €€€r?   Ú
add_actionzGScheduleDualPipeV._calculate_single_rank_operations.<locals>.add_action°  sº   ø€ ð $¥}Ò4Ð4ð Ð.Ð/Ð/à!¥>Ð2ð ð
  —|’| C¨Ñ+Ô+ˆHØ�NŠN�7 ;Ð0@À(ÑKÔKÑLÔLÐLð  ¥=Ò0Ð0Ø)Ð)¨+Ñ6Ô6Ð6Ð6Ð6ð $¥~Ò5Ð5à ×'Ò'¨°hÐ(?Ñ@Ô@Ð@Ø (¨1¡�˜‘��rK   c                 óÜ   •— ‰sdS ‰                      d¦  «        \  }}|                      t          |t          |¦  «        ¦  «         |t          f}‰                     |d¦  «        dz   ‰|<   dS )z4Helper method to add a weight action from the queue.Nr   r   )rÙ  ro   rM   rF   r‹   )r„   Úactual_stage_indexrÎ  r  r  r(  s       €€r?   Úadd_weight_action_if_pendingzYScheduleDualPipeV._calculate_single_rank_operations.<locals>.add_weight_action_if_pendingÈ  s„   ø€ àð Ø�à2>×2BÒ2BÀ1Ñ2EÔ2EÑ/Ð Ø�NŠNÝØ&Ý#Ø#ñô ñô ð ð -­oÐ>ˆJØ#+§<¢<°
¸AÑ#>Ô#>ÀÑ#BˆH�ZÑ Ð Ð rK   r   r   )r!  r"  FT)
r•  r½   r   rt   r¦   r+   r£   rD   rE   rG   )rV   rª   r„   r®   Ú
num_chunksÚrank_to_stagesÚstage0_indexÚstage1_indexr&  r)  r,  Ústep_1r¤  Ústep_2Ústep_3Ústep_4rˆ   Ústep_5Ústep_6Ú	enable_zbr¥  Ústep_7Ústep_8r  r   r(  s                          @@@r?   r¯  z3ScheduleDualPipeV._calculate_single_rank_operationsƒ  s…  øøø€ Ø(*ˆð ð 	ð ˆàÔ&ˆ	ØÔ)ˆ
å7Ø�y 1‘}¨Cð
ñ 
ô 
ˆð &4°DÔ%9Ñ"ˆ�lð	Cµ3ð 	Cð 	Cð 	Cð 	Cð 	Cð 	Cð	6Ýð	6åð	6õ  ð	6ð 	6ð 	6ð 	6ð 	6ð 	6ð 	6ð.	-Ýð	-åð	-õ /ð	-ð 	-ð 	-ð 	-ð 	-ð 	-ð 	-ð 	-ð0	Cµ$ð 	Cð 	Cð 	Cð 	Cð 	Cð 	Cð 	Cð$ ˜dÑ" QÑ&¨!Ñ+ˆÝ�v‘”ð 	7ð 	7ˆAØˆJ�w ­gÑ6Ô6Ð6Ð6ð ˜‘ˆÝ�v‘”ð 	7ð 	7ˆAØˆJ�w ­gÑ6Ô6Ð6ØˆJ�w ­gÑ6Ô6Ð6Ð6ð ˜TÑ! AÑ%ˆÝ�v‘”ð 	7ð 	7ˆAØˆJ�w ­nÑ=Ô=Ð=Ø(Ð(¨Ñ1Ô1Ð1ØˆJ�w ­gÑ6Ô6Ð6Ð6ð ˜i¨!™mÑ+¨dÑ2°QÑ6ˆÝ�v‘”ð 	ð 	ˆAØ�AŠvˆv˜$ )¨a¡-Ò/Ð/à�
˜7 Lµ'Ñ:Ô:Ð:Ø�
˜7 Lµ-Ñ@Ô@Ð@Ð@à�ØØ".Ø#/ðñ ô ð ð
 ˆOØØ*Ø+ðñ ô ð ð ð ˜TÑ! AÑ%ˆÝ�v‘”ð 	ð 	ˆAØˆJ�w ­mÑ<Ô<Ð<ØˆOØØ*Ø+ðñ ô ð ð ð ˜‘ˆØˆ	Ý�v‘”ð 	9ð 	9ˆAØ�F˜a‘KÒÐ D¨1¡H°¢M MØ �	Ø*3ÐF�˜½ˆIØˆJ�w ¨iÑ8Ô8Ð8Ø�F˜a‘KÒÐ D¨1¡H°¢M MØ �	Ø*3ÐF�˜½ˆIØˆJ�w ¨iÑ8Ô8Ð8Ð8ð ˜TÑ! AÑ%ˆÝ�v‘”ð 	9ð 	9ˆAØ(Ð(¨Ñ1Ô1Ð1Ø*3ÐF�˜½ˆIØˆJ�w ¨iÑ8Ô8Ð8Ð8ð ˜‘ˆÝ�v‘”ð 	2ð 	2ˆAØ(Ð(¨Ñ1Ô1Ð1Ð1àˆrK   rê  rë  rw  s   @r?   r)   r)   A  s'  ø€ € € € € ðð ð $(Ø>BØ?CØ@DØ Ø+/Ø#ð8?ð 8?àÐ'Ô(ð8?ð ð8?ð ˜D‘ð	8?ð
 ˜°Ð3Ô4°tÑ;ð8?ð    _Ð 4Ô5¸Ñ<ð8?ð    S œ>¨E°#¬JÑ6¸Ñ=ð8?ð ð8?ð %)ð8?ð ð8?ð 8?ð 8?ð 8?ð 8?ð 8?ðt^¸¸gÈ¹nÔ9Mð ^ð ^ð ^ð ^ð ^ð ^ð ^ð ^rK   r)   Úschedule_namec           
      ó@  — t           t          t          t          t          t
          t          t          t          dœ	}d„ |D ¦   «         }|  	                    ¦   «         }||vr4t          d| › dt          |                     ¦   «         ¦  «        › �¦  «        ‚|||                  S )z–
    Maps a schedule name (case insensitive) to its corresponding class object.

    Args:
        schedule_name (str): The name of the schedule.
    )	Ú1F1BÚInterleaved1F1BÚGPipeÚ	LoopedBFSÚInterleavedZeroBubbler!   r"   ÚZBVZeroBubbleÚ	DualPipeVc                 ó8   — i | ]}|                      ¦   «         |“ŒS rJ   )Úlower)r[   rý  s     r?   rá  z&get_schedule_class.<locals>.<dictcomp>6  s"   € Ð9Ð9Ð9 q�a—g’g‘i”i Ð9Ð9Ð9rK   zUnknown schedule name 'z'. The valid options are )r#   r%   r$   r&   r'   r!   r"   r(   r)   rD  r<   r¦   Úkeys)r:  Úschedule_mapÚlowercase_keysÚlowercase_schedule_names       r?   r    r    $  sª   € õ Ý2ÝÝ&Ý!>Ý"8Ý!6Ý.Ý&ð
ð 
€Lð :Ð9¨LÐ9Ñ9Ô9€NØ+×1Ò1Ñ3Ô3ÐØ nÐ4Ð4ÝØi mÐiÐiÍdÐS_×SdÒSdÑSfÔSfÑNgÔNgÐiÐiñ
ô 
ð 	
ð ˜Ð'>Ô?Ô@Ð@rK   c                 ó’  ‡ ‡‡‡	‡
— ˆ fd„t          ‰ ¦  «        D ¦   «         Š d„ t          ‰ ¦  «        D ¦   «         Š
d„ ‰
D ¦   «         Š	dt          dt          dz  fˆ	ˆ
fd„}dt          dz  dt          fˆ	ˆˆfd	„}‰ �rÍd
}t          ‰ ¦  «        D ]m}t	          ‰ |         ¦  «        dk    rŒ‰ |         d         } ||¦  «        r,|� |||¦  «         ‰ |                              d¦  «         d}Œa ||d¦  «         Œnt          ‰ d¬¦  «        D ]}t	          ‰ |         ¦  «        dk    r‰ |= Œt          ‰ ¦  «        D ]‡}t	          ‰ |         ¦  «        dk    rŒ‰
|         d         �Œ+‰ |         d         } ||¦  «        rC|�&|‰
|         d<   ‰	|                              |¦  «         ‰ |                              d¦  «         Œˆt          ‰ d¬¦  «        D ]}t	          ‰ |         ¦  «        dk    r‰ |= Œ|sRt          dt          ‰
¦  «        ¦  «         ‰ D ]#}t          d|›d‰ |         d         › �¦  «         Œ$t          d¦  «        ‚‰ �°Í‰
S )aÂ  This function dry-run simulates the actions in the schedule from the perspective of all ranks, and flags
    any deadlocks caused by missing or misordered communications.  It also simulates any bubbles in time where a rank
    can not execute any action due to waiting for unmet dependencies.  The total number of simulator steps can be used
    as a metric for unit tests involving IR optimization passes as reordering and merging of IR can reduce the number
    of simulated steps.

    The simulation is not high-fidelity and does not model overlapping of compute and communication, or cuda streams.
    Future work may be to enhance this and model the compute time, comms overlap, and even memory.
    c                 ó6   •— i | ]}|d „ ‰|         D ¦   «         “ŒS )c                 ó   — g | ]}|®|‘ŒS rS   rJ   )r[   rµ  s     r?   r]   z6_simulate_comms_compute.<locals>.<dictcomp>.<listcomp>L  s   € Ð@Ð@Ð@�Q°!°-ˆq°-°-°-rK   rJ   )r[   rª   r€   s     €r?   rá  z+_simulate_comms_compute.<locals>.<dictcomp>K  s?   ø€ ð ð ð àð 	Ð@Ð@˜.¨Ô.Ð@Ñ@Ô@ðð ð rK   c                 ó   — i | ]}|g “ŒS rJ   rJ   rà  s     r?   rá  z+_simulate_comms_compute.<locals>.<dictcomp>O  s'   € ð 2ð 2ð 2Øˆˆbð2ð 2ð 2rK   c                 ó,   — i | ]}|t          ¦   «         “ŒS rJ   rã  rà  s     r?   rá  z+_simulate_comms_compute.<locals>.<dictcomp>S  s   € Ð.QÐ.QÐ.Q¸t¨tµS±U´UÐ.QÐ.QÐ.QrK   rª   r8   Nc                 ó|   •— ‰|                                |¦  «         |�‰|                               |¦  «         d S d S rS   )ro   rÃ  )rª   r8   Ú_prev_ops_rankÚ	_schedules     €€r?   Úadd_to_schedulez0_simulate_comms_compute.<locals>.add_to_scheduleU  sH   ø€ Ø�$Œ×Ò˜vÑ&Ô&Ð&ØÐØ˜4Ô ×$Ò$ VÑ,Ô,Ð,Ð,Ð,ð ÐrK   r9   c                 ó®  •— | €dS | j         }‰ ‰
|¦  «                 }| j        t          k    rZ| j         dk    rdS t          | j         t          | j        ¦  «        |v rdS t          | j         dz
  t          | j        ¦  «        |v rdS dS | j        t          t          fv r„| j         ‰	dz
  k    rdS t          | j         t          | j        ¦  «        |v rdS t          | j         dz   t          | j        ¦  «        |v rdS t          | j         dz   t          | j        ¦  «        |v rdS dS | j        t          k    rdS | j        t          k    r$t          | j         t          | j        ¦  «        }||v S | j        t          k    r3|dz
  }t          |t          | j        ¦  «        }|‰ ‰
|¦  «                 v S | j        t          k    rHt          | j         t          | j        ¦  «        }t          | j         t          | j        ¦  «        }||v p||v S | j        t          k    r3|dz   }t          |t          | j        ¦  «        }|‰ ‰
|¦  «                 v S t          d| › �¦  «        ‚)NTr   r   FzUnsupported action type )rN   rO   r,   rM   r2   rP   rE   rG   r4   rF   r1   r3   r<   )r8   r»  Úprev_opsÚ
expected_fÚpeer_stage_idxÚexpected_sendÚ
expected_bÚexpected_bwrO  rc  rÝ  s           €€€r?   rî  z3_simulate_comms_compute.<locals>._ready_to_scheduleZ  s‰  ø€ Øˆ>Ø�4àÔ&ˆ	Ø! - -°	Ñ":Ô":Ô;ˆØÔ"¥aÒ'Ð'ØÔ! QÒ&Ð&Ø�tå˜Ô*­F°FÔ4KÑLÔLÐPXÐXÐXà�tå˜Ô*¨QÑ.µ°6Ô3JÑKÔKÈxÐWÐWà�tØ�5ØÔ$­½Ð(GÐGÐGØÔ! Z°!¡^Ò3Ð3Ø�tÝ�vÔ)­6°6Ô3JÑKÔKÈxÐWÐWØ�tå˜Ô*¨QÑ.µÀÔ@WÑXÔXØðð ð �tå˜Ô*¨QÑ.µ¸vÔ?VÑWÔWØðð ð �tØ�5ØÔ$­Ò7Ð7Ø�4ØÔ$­Ò.Ð.Ý  Ô!3µQ¸Ô8OÑPÔPˆJØ Ð)Ð)ØÔ$­Ò.Ð.Ø&¨™]ˆNÝ# NµF¸FÔ<SÑTÔTˆMØ  N°=°=ÀÑ3PÔ3PÔ$QÐQÐQØÔ$­Ò.Ð.Ý ØÔ"¥N°FÔ4Kñô ˆJõ "ØÔ"¥M°6Ô3Jñô ˆKð  Ð)ÐD¨[¸HÐ-DÐDØÔ$­Ò.Ð.Ø&¨™]ˆNÝ# NµF¸FÔ<SÑTÔTˆMØ  N°=°=ÀÑ3PÔ3PÔ$QÐQÐQåÐ@¸Ð@Ð@ÑAÔAÐArK   Fr   T)Úreverserj   zWIP comms schedule:
rï  z next action= zSchedule is not progressing)
r¥   rt   rM   r|   ru   rÙ  rÃ  Úprintr³   r<   )r€   rÝ  rc  rQ  rî  rò  rª   r8   rˆ   rO  rP  s   ```      @@r?   r•  r•  ?  sH  øøøøø€ ðð ð ð å˜>Ñ*Ô*ðñ ô €Nð2ð 2Ý# NÑ3Ô3ð2ñ 2ô 2€Ið /RÐ.QÀyÐ.QÑ.QÔ.Q€Nð-�cð -­7°T©>ð -ð -ð -ð -ð -ð -ð -ð
8B¥7¨T¡>ð 8Bµdð 8Bð 8Bð 8Bð 8Bð 8Bð 8Bð 8Bð 8Bðt ñ +<ØˆÝ˜>Ñ*Ô*ð 	,ð 	,ˆDÝ�> $Ô'Ñ(Ô(¨AÒ-Ð-Øà# DÔ)¨!Ô,ˆFØ!Ð! &Ñ)Ô)ð ,ØÐ%Ø#�O D¨&Ñ1Ô1Ð1Ø˜tÔ$×(Ò(¨Ñ+Ô+Ð+Ø��à�  dÑ+Ô+Ð+Ð+å˜°Ð5Ñ5Ô5ð 	&ð 	&ˆAÝ�> !Ô$Ñ%Ô%¨Ò*Ð*Ø" 1Ð%øõ ˜>Ñ*Ô*ð 	,ð 	,ˆDÝ�> $Ô'Ñ(Ô(¨AÒ-Ð-Øà˜Œ˜rÔ"Ð.Øà# DÔ)¨!Ô,ˆFØ!Ð! &Ñ)Ô)ð ,ØÐ%Ø*0�I˜d”O BÑ'Ø" 4Ô(×,Ò,¨VÑ4Ô4Ð4Ø˜tÔ$×(Ò(¨Ñ+Ô+Ð+øå˜°Ð5Ñ5Ô5ð 	&ð 	&ˆAÝ�> !Ô$Ñ%Ô%¨Ò*Ð*Ø" 1Ð%øàð 	<ÝÐ)Õ+AÀ)Ñ+LÔ+LÑMÔMÐMØ&ð Ið I�ÝÐG˜ÐGÐG¨n¸TÔ.BÀ1Ô.EÐGÐGÑHÔHÐHÐHÝÐ:Ñ;Ô;Ð;ðW ñ +<ðZ ÐrK   c                 ó‚  — g }t          | ¦  «        D ]g}t          | |         ¦  «        D ]O\  }}|€Œ|                     t          |¦  «        |j        t
          t          t          fv rdndd|||ddœ¦  «         ŒPŒhddl}t          |d¦  «        5 }| 
                    d	|i|¦  «         ddd¦  «         dS # 1 swxY w Y   dS )
aï  
    This function dumps a schedule IR into a chrometrace format so it can be visualized.

    It is currently very basic and only serves as a graphical alternative to dumping the schedule IR as text.

    As future work we may extend this to include more accurate heuristics for durations, or let users input durations,
    add 'flow events' to let the UI show the connection between sends and recvs, and model cuda streams for comm/compute
    as separate streams on the chrometrace view.
    NÚcomputationÚcommunicationÚXr   )r)  ÚcatÚphÚpidÚtidÚtsÚdurr   r]  ÚtraceEvents)r¥   rž   ro   rI   rO   r,   r5   r.   ÚjsonrG  Údump)ÚschedulerK  Úeventsrª   Útimestepr8   rf  Úfs           r?   Ú_dump_chrometracerl  Ä  s?  € ð €FÝ�xÑ Ô ð ð ˆÝ )¨(°4¬.Ñ 9Ô 9ð 	ð 	ÑˆH�fØˆ~ØØ�MŠMå ™KœKð "Ô2µq½!½Q°iÐ?Ð?ð &˜à,àØØØ"Øðð ñô ð ð ð	ð$ €K€K€Kå	ˆh˜Ñ	Ô	ð . Ø�	Š	�= &Ð)¨1Ñ-Ô-Ð-ð.ð .ð .ñ .ô .ð .ð .ð .ð .ð .ð .ð .øøøð .ð .ð .ð .ð .ð .s   ÂB4Â4B8Â;B8rÞ   c           
      ó
  — | D ]}t          |j        t          j        j        ¦  «        sŒ'|j                             ¦   «         D ]>}t          |t          ¦  «        r't          d|› dt          |¦  «        j	        › �¦  «        ‚Œ?Œ€dS )zþ
    Check if the schedule is compatible with torch.compile.

    Args:
        stages: List of pipeline stages to check
        schedule_name: Name of the schedule for error message

    Raises:
        RuntimeError: If any stage uses torch.compile
    zThe ze schedule is not supported with stage modules that have used torch.compile. Found OptimizedModule in N)
rÚ   r˜  r  ÚnnÚModulerŸ  r   r=   r  rA   )rÞ   r:  rË   Úmodules       r?   rî  rî  è  s¯   € ð ð 
ð 
ˆÝ˜%œ,­¬¬Ñ8Ô8ð 	Øà”l×*Ò*Ñ,Ô,ð 	ð 	ˆFÝ˜&¥/Ñ2Ô2ð Ý"ðH˜=ð Hð Hå04°V±´Ô0EðHð Hñô ð ðð	ð	
ð 
rK   rS   )r“  )r   F)r–   )sr¡   rH  r§   ÚloggingÚreÚabcr   r   Úcollectionsr   r   Úcollections.abcr   Údataclassesr   Úenumr	   Ú	functoolsr
   Útypingr   r   r   r   r   r  Útorch.distributedÚdistributedrL  Útorch._dynamor   Útorch.distributed.fsdpr   r   Útorch.nn.modules.lossr   Útorch.profilerr   Ú_utilsr   r   r   rõ  r   r   r   r   rË   r   r   r   Ú__all__Ú	getLoggerrA   rÄ   rI   r+   rD   rE   rF   r/   r0   r1   r2   r3   r4   rG   r6   r7   rq  r,   r-   r.   r5   Úcompilerq   rM   r   r:  rt   r¦   r³   rµ   ÚP2POpÚWorkró   rY  rò   r!   ry  r$   r#   r|   r±  r”  r×  rÜ  rô  r  r  r"   rs  rv  r{  r&   rÏ  rÔ  r%   r'   r(   r)   r    r•  rl  rî  rJ   rK   r?   ú<module>r†     s$
  ðð €€€Ø 
€
€
€
Ø Ð Ð Ð Ø €€€Ø 	€	€	€	Ø #Ð #Ð #Ð #Ð #Ð #Ð #Ð #Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ø $Ð $Ð $Ð $Ð $Ð $Ø !Ð !Ð !Ð !Ð !Ð !Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;à €€€Ø  Ð  Ð  Ð  Ð  Ð  Ø )Ð )Ð )Ð )Ð )Ð )Ø <Ð <Ð <Ð <Ð <Ð <Ð <Ð <Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ø *Ð *Ð *Ð *Ð *Ð *ðð ð ð ð ð ð ð ð ð ð
ð ð ð ð ð ð ð ð ð ð ð ð @Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?ðð ð €ð 
ˆÔ	˜8Ñ	$Ô	$€ðNð Nð Nð Nð N�s˜Dñ Nô Nð Nð. Ô
"€Ø!Ô0€Ø"Ô2€Ø
Ô
"€Ø
Ô
"€Ø	Ô	 €Ø	Ô	 €Ø	Ô	 €Ø	Ô	 €Ø Ô.€ØÔ*€ØÔ*€ð %�_ QÑ'Ô'Ð ð €Ø€Ø€Ø€ð �”
ØRñô €ð
T
ð T
ð T
ð T
ð T
ˆjñ T
ô T
ð T
ðn ð¨ð °Cð ð ð ñ „ðð %)ð<ð <Ø˜˜d 7¨T¡>Ô2Ð2Ô3ð<à˜T‘zð<ð 	ð<ð <ð <ð <ð~d
ð d
ð d
ð d
ð d
˜ñ d
ô d
ð d
ðN+ð +˜˜TœZÔ(ð +°°d±
ð +ÀdÈ4Ì9Äoð +ð +ð +ð +ð: 37ðð Ø�$”*ÔðØ%(¨4¡Zðà	ˆ#ˆt�D”IŒÐ
Ôðð ð ð ð6˜$˜tœyœ/ð ð ð ð ðBð Bð Bð Bð BÐ.ñ Bô Bð BðJ2"ð 2"ð 2"ð 2"ð 2"Ð1ñ 2"ô 2"ð 2"ðjxð xð xð xð xÐ*ñ xô xð xðvzð zð zð zð zÐ)ñ zô zð zðz!Ð'7ð !¸Dð !ð !ð !ð !ð$Ø�'˜D‘.Ô!ð$Ø36ð$à	ˆ'�D‰.Ôð$ð $ð $ð $ðF ðPð PØ˜' D™.Ô)ðPàðPð 
ˆ'„]ðPð Pð Pð Pðf#Ø˜' D™.Ô)ð#à	ˆ'„]ð#ð #ð #ð #ðLtØ˜#˜t Gœ}Ð,Ô-ðtà˜S˜E 3˜JÔ'ðtð ðtð 
ˆ#ˆt�GŒ}Ð
Ôð	tð tð tð tðn[Ø�#�t˜G”}Ð$Ô%ð[à˜S˜E 3˜JÔ'ð[ð 
ˆ#ˆt�GŒ}Ð
Ôð[ð [ð [ð [ð|'Ø�#�t˜G d™NÔ+Ð+Ô,ð'àð'ð ð'ð ð	'ð
 
ˆ#ˆsˆ(„^ð'ð 'ð 'ð 'ðDA2ð A2ð A2ð A2ð A2Ð-ñ A2ô A2ð A2ðH ðð ð ð ð ñ ô ñ „ððLð Lð Lð Lð L˜hñ Lô Lð Lð}2ð }2ð }2ð }2ð }2Ð4ñ }2ô }2ð }2ð@Dð Dð Dð Dð DÐ0ñ Dô Dð Dð` ØðFð Fð Fð Fð^ ð<ð <Ø
ð<àð<ð  ð<ð ð	<ð
 ð<ð ð<ð 	ð<ð <ð <ð <ð&q
ð q
ð q
ð q
ð q
Ð6ñ q
ô q
ð q
ðh}ð }ð }ð }ð }Ð$<ñ }ô }ð }ð@ð ð ð ð Ð4ñ ô ð ðD`ð `ð `ð `ð `Ð0ñ `ô `ð `ðFA cð Að Að Að Að6BØ#+¨S¨E°3¨JÔ#7ðBØEHðBð Bð Bð BðJ!.ð !.ð !.ðHØÐ#Ô$ðØ58ðð ð ð ð ð rK   