
    IЦiX3                        S SK r S SKJrJrJrJr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/J0r0  S SK1J2r2  S SK3J4r4  S SK5J6r6  S SK7J8r8  \\9\\\\:      \\:   4   4   r;S/r<S)S\:S\9S\94S jjr= S*S\\R|                     S\4S jjr?S\	R                  S\A4S jrB S)S\S\\:   S\9S\	R                  4S jjrCS \!S\\;\\R|                     4   4S! jrD " S" S#\5      rE S*S$\!S%\9S&\,S'\\%   S\!4
S( jjrFg)+    N)castDictListOptionalSequenceTuple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      e/var/www/html/ai-image-ml/venv/lib/python3.13/site-packages/torch/distributed/checkpoint/optimizer.py_gen_rank_devicer.   5   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   r   r	   r"   str)r0   pg_device_typeidxr6   s       r-   _create_colwise_specrB   @   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)r:   r   lenlocal_shardstensorr#   
ValueError_local_tensor)rC   s    r-   _is_nested_tensorrJ   T   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   torchrQ   r
   current_deviceemptyrM   rN   rO   rP   )rK   r=   r&   rQ   s       r-   _alloc_tensorrU   c   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=   rJ   rE   rF   
isinstancer   metadatashard_offsetsshard_sizesrG   _process_group)rV   specsdp_pgkeyvalueshards         r-   _get_state_dict_2d_layoutrd   w   s     #%E)-E &&(
EJJL)
U##E&&()Q.767.}  656  &&(+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   translationrV   r[   fqn_to_offsetr'   Nc                 j   > [         TU ]  5         Xl        [        0 5      U l        0 U l        0 U l        g N)super__init__ri   r   r[   rV   rh   )selfri   	__class__s     r-   rm   _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      $ )NrX   r   )offsetssizes)offset)rh   rV   rY   r[   state_dict_metadatarZ   r   r   ri   rE   rF   r   rR   Sizer   r\   r]   r   r   r   
dest_indexrt   r   dataclassesreplacer   )rn   requestsfqnobjmdrt   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      $ rk   )rl   lookup_tensorrh   get)rn   r   ro   s     r-   r   _ReaderWithOffset.lookup_tensor   s$    w$T%5%5%9%9%%GHHr/   )ri   r[   rV   rh   )__name__
__module____qualname____firstlineno__r   r   __annotations__r   r   r?   r   intrm   r   r   rR   Tensorr   __static_attributes____classcell__)ro   s   @r-   rf   rf      sm    m]233d3+=&> 4 ("8 ("TI= IU\\ I Ir/   rf   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)
Nr2   r3   r   r4   z
<bytes_io>rX   )rank
world_sizenum_devices_per_noder0      )rM   rN   rO   memory_formatrP   )rG   r[   )process_group)rV   r   r   )2read_metadatard   r7   r8   r9   r:   r
   r;   r<   r   r+   appendr   rB   ru   rY   planner_datarZ   r   r=   numelrU   
propertiesr!   get_rankr    r   ShardTensorPropertiesrM   rN   rO   r   rP   build_metadatarR   rv   shards_metadatar   r"   	placementr   r   r]   r   +_init_from_local_shards_and_global_metadatar   r   r   rf   r   )r   r   r   r   r[   layout_specsr`   dp_pg_device_typer,   r6   idevice_infosharding_specrV   ri   ra   rb   key_pathspec_key
alloc_sizer   st_mdrF   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/   )cudark   )Grx   typingr   r   r   r   r   r   r	   rR   torch.distributeddistributedr7   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   STATE_DICT_2D_LAYOUT__all__r.   ProcessGrouprB   r   boolrJ   rU   rd   rf   r$    r/   r-   <module>r      s    E E E    + 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/   