
    [Thb3                        S SK r S SKJr  S SKJrJrJr  S SKrS SKJ	r
  S SKJr  S SKJr  S SKJr  S SKJr  S SKJr  S S	KJr  S S
KJr  S SKJrJrJrJrJrJrJ r   S SK!J"r"J#r#  S SK$J%r%J&r&  S SK'J(r(  S SK)J*r*  S SK+J,r,J-r-J.r.  S SK/J0r0  S SK1J2r2  S SK3J4r4  S SK5J6r6  \7\8\9\\\:      \\:   4   4   r;S/r<S*S\:S\8S\84S jjr= S+S\\
R|                     S\4S jjr?S\R                  S\A4S jrB S*S\S\\:   S\8S\R                  4S  jjrCS!\S\9\;\\
R|                     4   4S" jrD " S# S$\5      rE S+S%\S&\8S'\*S(\\#   S\4
S) jjrFg),    N)Sequence)castOptionalUnion)_get_device_module)ShardedTensor)TensorProperties)Shard)ChunkShardingSpec)unflatten_state_dict)DefaultLoadPlanner)BytesStorageMetadataChunkStorageMetadataMetadataMetadataIndexSTATE_DICT_TYPEr	   TensorStorageMetadata)LoadPlanLoadPlanner)_create_read_items create_read_items_for_chunk_list)load_state_dict)StorageReader)_element_wise_add_element_wise_sub_normalize_device_info)_get_default_group)_create_chunk_sharded_tensor)_remote_device)DTensor!load_sharded_optimizer_state_dictglobal_rankdevice_typereturnc                     US:X  a  g[        U5      nUR                  5       (       a  [        XUR                  5       -  5      $ g)Ncpu)r   is_availabler   device_count)r"   r#   device_modules      ^/var/www/auris/envauris/lib/python3.13/site-packages/torch/distributed/checkpoint/optimizer.py_gen_rank_devicer+   6   sI    e&{3M!!##%}'A'A'CC
 	
     pgc                    [         R                  R                  U 5      R                  nU c>  [	        [         R
                  " 5       5       Vs/ s H  nSU S[        X!5       3PM     nnOM[	        U R                  5       5       Vs/ s H)  nSU S[        [         R                  " X5      U5       3PM+     nn[        S[        [        [        [        [        4      U5      S9$ s  snf s  snf )Nrank:/r   dim
placements)distdistributed_c10d_get_pg_default_devicetyperangeget_world_sizer+   sizeget_global_rankr   r   listr   r   str)r-   pg_device_typeidxr3   s       r*   _create_colwise_specr@   A   s     **AA"EJJN	z T0023
3 C5*3?@A3 	 

 RWWY'
' C5*4+?+?+H.YZ[' 	 
 U>3#678*E 


s   C$0C)valc                    [        U 5      [        L a  [        U R                  5       5      S:X  a  g[        U R                  5       S   R                  5      [        L a  g[        U R                  5       S   R                  5      [
        L a  [        S5      e g[        U 5      [
        L aC  [        U R                  5      [
        L d  [        U R                  5      [        L a  [        S5      eg)Nr   FTz2Cannot handle DTensor nested insided ShardedTensorzCannot handle nested DTensor)r7   r   lenlocal_shardstensorr    
ValueError_local_tensor)rA   s    r*   _is_nested_tensorrH   U   s    CyM!s!"a'  "1%,,->  "1%,,-8QRR 9 	 
cg	S7*d33D3D.E.V788r,   propsr:   c           	      P   US:X  a2  [        [        R                  [        U5      R	                  5       5      nO.[        R                  " U[        U5      R	                  5       5      n[        R
                  " UU R                  U R                  U R                  U R                  US9$ )Nr&   )r:   dtypelayoutrequires_grad
pin_memorydevice)
r   torchrO   r   current_deviceemptyrK   rL   rM   rN   )rI   r:   r#   rO   s       r*   _alloc_tensorrS   d   s     eell$6{$C$R$R$TU+K8GGI
 ;;kk||))## r,   
state_dictc                    0 nSnU R                  5        H  u  p4SUR                  5       4X'   [        U5      (       d  M+  [        UR	                  5       5      S:X  d   S5       e[        U[        5      (       d   S5       eUR	                  5       S   nUR                  R                  UR                  R                  4X'   UR                  R                  nM     UU4$ )a  
Load the right TP slice of the optimizer state.

This is not easy since the per-tensor slicing can't be inferred from checkpoint metadata.
We take advantage of the model state_dict producing a sliced ST to figure out what we need to load.
This is pretty fragile and it might be easier for FSDP to compute this info for us.
Returns a dictionary where keys are the same of the state_dict and the value is a tuple of
(offset, size) for the current rank TP slice.
N.B. The state_dict *MUST* come from FSDP.sharded_state_dict.
N   z%Cannot handle ST with multiple shardsz$Can only handle nested ShardedTensorr   )itemsr:   rH   rC   rD   
isinstancer   metadatashard_offsetsshard_sizesrE   _process_group)rT   specsdp_pgkeyvalueshards         r*   _get_state_dict_2d_layoutrb   x   s     #%E)-E &&(
EJJL)
U##u))+,1 71 e]33 63 &&(+E,,**EJ LL//E )" 	 r,   c                      ^  \ rS rSr% \\\4   \S'   \\S'   \\S'   S\\	\
\   4   SS4U 4S jjrS\4S	 jrS
\S\R                   4U 4S jjrSrU =r$ )_ReaderWithOffset   translationrT   rY   fqn_to_offsetr$   Nc                 j   > [         TU ]  5         Xl        [        0 5      U l        0 U l        0 U l        g N)super__init__rg   r   rY   rT   rf   )selfrg   	__class__s     r*   rk   _ReaderWithOffset.__init__   s.    * r,   c           	         / n0 U l         U R                  R                  5        GH  u  p#U R                  R                  U   n[        U[        5      (       d  U[        X$U5      -  nME  X R                  ;  a  U[        X$U5      -  nMe  U R                  U   n[        UR                  5       5      S:X  d   eUR                  5       S   n[        [        R                  " [        UR                  R                  U5      5      [        R                  " UR                  R                   5      S9/n[#        U[%        [&        U5      U5      nU H  n	U	R(                  R*                  c   e[-        U	R(                  R*                  U5      n
[.        R0                  " U	R(                  [        R                  " U
5      S9nXR                   U	R(                  '   M     X-  nGM     [3        U5      $ )NrV   r   )offsetssizes)offset)rf   rT   rW   rY   state_dict_metadatarX   r   r   rg   rC   rD   r   rP   Sizer   rZ   r[   r   r   r   
dest_indexrr   r   dataclassesreplacer   )rl   requestsfqnobjmdrr   original_shardlocal_chunksreqsrioriginal_offsetoriginal_indexs               r*   create_local_plan#_ReaderWithOffset.create_local_plan   s   --/HC2237Bc=11.s<<,,,.s<<'',Fs'')*a/// --/2N$!JJ).*A*A*O*OQWX  **^%<%<%H%HI	L 4T/4lD
 }}++777"3BMM4H4H&"Q!,!4!4MM%**_*E" 3A  /  HI 0J !!r,   indexc                 T   > [         TU ]  U R                  R                  X5      5      $ ri   )rj   lookup_tensorrf   get)rl   r   rm   s     r*   r   _ReaderWithOffset.lookup_tensor   s$    w$T%5%5%9%9%%GHHr,   )rg   rY   rT   rf   )__name__
__module____qualname____firstlineno__dictr   __annotations__r   r   r=   r   intrk   r   r   rP   Tensorr   __static_attributes____classcell__)rm   s   @r*   rd   rd      sm    m]233d3+=&> 4 ("8 ("TI= IU\\ I Ir,   rd   model_state_dictoptimizer_keystorage_readerplannerc                 8   UR                  5       n[        U 5      u  pV[        R                  R	                  U5      R
                  n[        U5      nUce  / n	[        [        R                  " 5       5       H6  n
[        XzUR                  5       -  5      nU	R                  SU
 SU 35        M8     [        SU	S9nO[        U5      n0 n0 nUR                  R                  5        GH  u  nnUR                   U   nUS   U:w  a  M!  [#        U[$        5      (       a  SX'   M<  UR&                  R)                  5       S:X  a%  [+        UR,                  UR&                  U5      X'   M  Ucl  [/        [+        UR,                  UR&                  U5      [        R0                  " 5       [        R                  " 5       UR                  5       [3        5       S9X'   M  US	   nUR5                  USUR&                  45      S   n[7        UR,                  R8                  UR,                  R:                  UR,                  R<                  UR,                  R>                  UR,                  R@                  S
9nURC                  [D        RF                  " U5      U5      n/ n[        R0                  " U5      nURH                   Hi  n[K        [L        URN                  5      RQ                  5       U:w  a  M1  UR                  [S        [+        UR,                  URT                  U5      US95        Mk     [V        RX                  " UUUS9nUU;   a(  UU   S   b  [K        [Z        [\           UU   S   5      X'   UX'   GM     [_        UUUb  [a        U5      OUS9  [c        XR                   5      nU$ )a3  
Load a state_dict in conjunction with FSDP sharded optimizer state.

This is the current recommended way to checkpoint FSDP.
>>> # xdoctest: +SKIP
>>> import torch.distributed.checkpoint as dist_cp
>>> # Save
>>> model: torch.nn.Model
>>> optim_params = model.parameters()
>>> optim = torch.optim.SGD(optim_params, lr=0.01)
>>> # Save
>>> with FSDP.state_dict_type(model, StateDictType.SHARDED_STATE_DICT):
>>>     state_dict = {
>>>         "optimizer": FSDP.optim_state_dict(model, optim),
>>>         "model": model.state_dict()
>>>     }
>>>     dist_cp.save_state_dict(
>>>         state_dict=optim_state,
>>>         storage_writer=dist_cp.FileSystemWriter("checkpoint"),
>>>         planner=dist_cp.DefaultSavePlanner(),
>>>     )
>>>
>>> # Load
>>> with FSDP.state_dict_type(model_tp, StateDictType.SHARDED_STATE_DICT):
>>>     model_state_dict = model_tp.state_dict()
>>>     checkpoint = {
>>>         "model": model_state_dict
>>>     }
>>>     dist_cp.load_state_dict(
>>>         state_dict=checkpoint,
>>>         storage_reader=dist_cp.FileSystemReader(checkpoint_file),
>>>         planner=dist_cp.DefaultLoadPlanner(),
>>>     )
>>>     model.load_state_dict(checkpoint["model_state"])
>>>
>>>     optim_state = dist_cp.load_sharded_optimizer_state_dict(
>>>         model_state_dict,
>>>         optimizer_key="optimizer",
>>>         storage_reader=dist_cp.FileSystemReader("checkpoint"),
>>>     )
>>>
>>>     flattened_osd = FSDP.optim_state_dict_to_load(
>>>        model, optim, optim_state["optimizer"]
>>>     )
>>>
>>>     optim.load_state_dict(flattened_osd)
Nr/   r0   r   r1   z
<bytes_io>rV   )rank
world_sizenum_devices_per_noder-      )rK   rL   rM   memory_formatrN   )rE   rY   )process_group)rT   r   r   )2read_metadatarb   r4   r5   r6   r7   r   r8   r9   r   r(   appendr   r@   rs   rW   planner_datarX   r   r:   numelrS   
propertiesr   get_rankr   r   ShardTensorPropertiesrK   rL   rM   r   rN   build_metadatarP   rt   shards_metadatar   r   	placementr   r
   r[   r   +_init_from_local_shards_and_global_metadatar   r   r   rd   r   )r   r   r   r   rY   layout_specsr^   dp_pg_device_typer)   r3   idevice_infosharding_specrT   rg   r_   r`   key_pathspec_key
alloc_sizer   st_mdrD   current_rankshard_mdsts                             r*   r!   r!      sJ   j ++-H34DEL--DDUKPP&'89M}
t**,-A0!}'A'A'C#CK aS+78	 .
 *aJG,U3 #%J.0M2288:
U((-A;-'e122*JO ::"+  %**.?JO ]:e..

<MN]]_..0%2%?%?%A%'JO  {H%))(T5::4FGJJ.&&,,''..#..<<#..<< ++66J "00J1GTEL==/L!11(:(:;@@BlR##,!,,h.B.BDU  "*	 2 JJe5B <'L,B1,E,Q%)(3-h9OPQ9R%S" JOq ;v %494E!-07	 &j2G2GHJr,   )cudari   )Grv   collections.abcr   typingr   r   r   rP   torch.distributeddistributedr4   torch._utilsr   +torch.distributed._shard.sharded_tensor.apir   0torch.distributed._shard.sharded_tensor.metadatar	   r   -torch.distributed._shard.sharded_tensor.shardr
   :torch.distributed._shard.sharding_spec.chunk_sharding_specr   )torch.distributed.checkpoint._nested_dictr   ,torch.distributed.checkpoint.default_plannerr   %torch.distributed.checkpoint.metadatar   r   r   r   r   r   $torch.distributed.checkpoint.plannerr   r   ,torch.distributed.checkpoint.planner_helpersr   r   .torch.distributed.checkpoint.state_dict_loaderr   $torch.distributed.checkpoint.storager   "torch.distributed.checkpoint.utilsr   r   r   "torch.distributed.distributed_c10dr   #torch.distributed.fsdp._shard_utilsr   torch.distributed.remote_devicer   torch.distributed.tensorr    r   r=   tupler   STATE_DICT_2D_LAYOUT__all__r+   ProcessGroupr@   r   boolrH   rS   rb   rd   r!    r,   r*   <module>r      s    $ ( (    + E @ X J K   G K > 
 B L : , Cx'>'M!NNO 
 (
# C S  '+""#(5<< D   FL#+C=?B
\\(""
$*;*;!<<="J7I* 7I| &*	N%NN "N k"	N
 Nr,   