-
Notifications
You must be signed in to change notification settings - Fork 21.6k
/
_fsdp_param.py
630 lines (577 loc) · 27.8 KB
/
_fsdp_param.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
import itertools
from dataclasses import dataclass, field
from enum import auto, Enum
from typing import Any, cast, List, Optional, Sequence, Tuple
import torch
import torch.nn as nn
from torch._prims_common import make_contiguous_strides_for
from torch.distributed._functional_collectives import AsyncCollectiveTensor
from torch.distributed._tensor import DTensor, Placement, Replicate, Shard
from torch.distributed._tensor.device_mesh import _mesh_resources
from torch.distributed._tensor.placement_types import DTensorSpec
from ._fsdp_api import CPUOffloadPolicy, MixedPrecisionPolicy, OffloadPolicy
from ._fsdp_common import (
_chunk_with_empty,
_from_local_no_grad,
_get_dim0_chunked_size,
_raise_assert_with_print,
_to_dtype_if_needed,
FSDPMeshInfo,
HSDPMeshInfo,
)
"""
[Note: FSDP tensors]
FSDP considers the following tensors:
- Original parameter: parameter passed to :class:`FSDPParam`, i.e. the one
on the module when applying FSDP
- Sharded parameter: sharding the original parameter on dim-0 as a DTensor
over the main mesh
- All-gather inputs: the ``torch.Tensor`` or ``Tensor`` s passed to all-gather,
derived from the sharded parameter
- All-gather output: the ``torch.Tensor`` or ``Tensor`` s resulting from
all-gathering the all-gather inputs
- Unsharded parameter: parameter used for forward/backward computation, derived
from the all-gather output; autograd leaf
We define these tensors to describe the general framework that can accomodate
extensions, where:
- all-gather-inputs = pre-all-gather-transform(sharded-parameter)
- unsharded-parameter = post-all-gather-transform(all-gather-outputs)
For the default ``torch.Tensor`` case, there is only one all-gather input, and
it shares the same underlying tensor data as the sharded parameter, meaning
that they can be thought of as the same tensors. The same applies for the
all-gather output and unsharded parameter. For non-``torch.Tensor`` extensions,
these equivalences may no longer hold due to the pre/post-all-gather
transforms, and some may have multiple all-gather inputs/outputs (e.g.
quantized data and scales).
[Note: FSDP and autograd]
FSDP dynamically frees and allocates the unsharded parameter. Since autograd
can pack a reference to it or a view to save for backward, we use storage
resizing to implement the freeing/allocation since that preserves the aliasing.
This implies that we construct the unsharded parameter object once and write to
it in-place thereafter. For the default ``torch.Tensor` original parameter
case, the all-gather output and unsharded parameter share the same
data, so we use storage resizing on the all-gather output.
"""
class ShardedState(Enum):
"""
- ``SHARDED``: The sharded parameter is registered to the module. It is the
only contributor to parameter memory.
- ``SHARDED_POST_FORWARD``: The unsharded parameter is resharded to a
smaller world size. Since this data should not be used for computation,
we do not register it to the module. Users should reshard the module
before any in-place modifications. Both it and the sharded parameter
contribute to parameter memory.
- ``UNSHARDED``: The unsharded parameter is registered to the module. Both
it and the sharded parameter contribute to parameter memory.
"""
SHARDED = auto()
SHARDED_POST_FORWARD = auto()
UNSHARDED = auto()
@dataclass
class ParamModuleInfo:
"""
For a parameter, this stores the module and the parameter name to be able
to do a parameter swap via ``setattr(module, param_name, ...)`` or to get
the parameter via ``getattr(module, param_name)``. We additionally save
shared modules and shared parameter names to update them accordingly.
"""
# Parameter names are unprefixed, e.g. "weight", not "lin.weight"
module: nn.Module
param_name: str
shared_modules: List[nn.Module] = field(default_factory=list)
shared_param_names: List[str] = field(default_factory=list)
@dataclass
class ExtensionsData:
# User-defined metadata passed from pre to post-all-gather
all_gather_metadata: Optional[Any] = None
# Save the all-gather input sizes to unflatten the all-gather outputs to ND
all_gather_input_sizes: Sequence[torch.Size] = () # ND
def clear(self):
self.all_gather_metadata = None
self.all_gather_input_sizes = ()
class FSDPParam:
"""
This class manages a parameter with FSDP or FSDP variants applied,
implementing dim-0 per-parameter sharding.
"""
orig_dtype: torch.dtype
param_dtype: Optional[torch.dtype]
reduce_dtype: Optional[torch.dtype]
_orig_size: torch.Size # ND
sharded_size: torch.Size # ND
contiguous_sharded_stride: Tuple[int, ...]
padded_sharded_param_size: torch.Size # ND
sharded_post_forward_size: torch.Size # ND
contiguous_sharded_post_forward_stride: Tuple[int, ...]
_sharded_param_data: torch.Tensor # 1D
sharded_param: nn.Parameter # ND
_sharded_post_forward_param_data: Optional[torch.Tensor] # 1D
_sharded_post_forward_param: Optional[nn.Parameter] # ND
_unsharded_param: nn.Parameter # ND
unsharded_accumulated_grad: Optional[torch.Tensor] # ND
_global_placements: Tuple[Placement, ...]
_global_size: torch.Size
_global_stride: Tuple[int, ...]
all_gather_outputs: List[torch.Tensor] # 1D
# DTensor attributes (only defined for DTensor `param`):
_tp_spec: DTensorSpec
# All-gather extension attributes
_extensions_data: ExtensionsData
_unsharded_inner_tensors: List[torch.Tensor]
def __init__(
self,
param: nn.Parameter,
module_info: ParamModuleInfo,
mesh_info: FSDPMeshInfo,
post_forward_mesh_info: Optional[FSDPMeshInfo],
device: torch.device,
mp_policy: MixedPrecisionPolicy,
offload_policy: OffloadPolicy,
):
self._module_info: ParamModuleInfo = module_info
self.mesh_info = mesh_info
self.post_forward_mesh_info = post_forward_mesh_info
self.device = device
self.offload_to_cpu: bool = isinstance(offload_policy, CPUOffloadPolicy)
self.pin_memory = (
self.offload_to_cpu and cast(CPUOffloadPolicy, offload_policy).pin_memory
)
self.grad_offload_event: Optional[torch.cuda.Event] = None
self._init_sharded_param(param, device)
if self.post_forward_mesh_info:
self._init_sharded_post_forward_param_metadata(param)
self._init_extensions()
self.all_gather_outputs: List[torch.Tensor] = []
self.unsharded_accumulated_grad = None
self._param_fqn: Optional[str] = None # prefixed from root module
# TODO: Remove this padding logic once DTensor pads the local tensor:
# https://github.com/pytorch/pytorch/issues/113045
self._post_load_hook_handle = (
module_info.module.register_load_state_dict_post_hook(
lambda *args, **kwargs: self.reset_sharded_param()
)
)
@torch.no_grad()
def _init_sharded_param(self, param: nn.Parameter, device: torch.device):
if param.device != device and param.device.type != "meta":
raise AssertionError(
f"Expects the parameter to already be moved to device {device} but got {param.device}"
)
# TODO: Replace the sharded DTensor parameter construction logic with
# `distribute_tensor` after https://github.com/pytorch/pytorch/issues/116101
# TODO: Simplify the following sharded parameter padding logic after
# https://github.com/pytorch/pytorch/issues/113045
self.is_dtensor = isinstance(param, DTensor)
if self.is_dtensor:
self._tp_spec = cast(DTensor, param)._spec
if (
self.mesh_info.shard_mesh_dim != 0
or self.mesh_info.replicate_mesh_dim is not None
):
raise NotImplementedError("Using TP with HSDP is not supported")
dp_mesh, tp_mesh = (self.mesh_info.mesh, self._tp_spec.mesh)
dp_global_mesh = _mesh_resources.get_parent_mesh(dp_mesh)
tp_global_mesh = _mesh_resources.get_parent_mesh(tp_mesh)
if dp_global_mesh != tp_global_mesh or (
dp_global_mesh is None or tp_global_mesh is None
):
raise AssertionError(
"FSDP requires the DP and TP mesh to have the same parent mesh but got: \n"
f"DP's global mesh: {dp_global_mesh}\nTP's global mesh: {tp_global_mesh}"
)
self._global_mesh = dp_global_mesh
if len(self._tp_spec.placements) != 1:
raise NotImplementedError(
f"FSDP only supports 1D TP, not {self._tp_spec.placements}"
)
global_placements: List[Placement] = [Replicate(), Replicate()]
global_dp_mesh_dim = _mesh_resources.get_parent_mesh_dim(dp_mesh)
global_tp_mesh_dim = _mesh_resources.get_parent_mesh_dim(tp_mesh)
assert global_dp_mesh_dim is not None # mypy
assert global_tp_mesh_dim is not None # mypy
# for PP, DP, TP case, dp mesh dim would be 1, tp mesh dim would be 2
# DP/TP would only live in the inner most 2-3 dims (HSDP + TP would be 3)
dp_tp_mesh_ndim = dp_mesh.ndim + tp_mesh.ndim
outer_mesh_ndim = self._global_mesh.ndim - dp_tp_mesh_ndim
if self._global_mesh.ndim > dp_tp_mesh_ndim:
global_dp_mesh_dim = global_dp_mesh_dim - outer_mesh_ndim
global_tp_mesh_dim = global_tp_mesh_dim - outer_mesh_ndim
# TODO: Hard code FSDP + TP; need to support HSDP + TP
global_placements[global_dp_mesh_dim] = Shard(0)
global_placements[global_tp_mesh_dim] = self._tp_spec.placements[0]
self._global_placements = tuple(global_placements)
self._global_size = param.size()
self._global_stride = param.stride()
param_data = cast(DTensor, param)._local_tensor
else:
self._global_mesh = self.mesh_info.mesh
if isinstance(self.mesh_info, HSDPMeshInfo):
self._global_placements = (Replicate(), Shard(0))
else:
self._global_placements = (Shard(0),)
self._global_size = param.size()
self._global_stride = param.stride()
param_data = param
self._orig_size = param_data.size()
shard_rank = self.mesh_info.shard_mesh_rank
shard_world_size = self.mesh_info.shard_mesh_size
chunks = _chunk_with_empty(param_data, shard_world_size, dim=0)
sharded_param = chunks[shard_rank]
self.sharded_size = _get_dim0_chunked_size(sharded_param, param_data.size())
self.contiguous_sharded_stride = make_contiguous_strides_for(self.sharded_size)
padded_sharded_size = chunks[0].size() # 0th always padded
padded_sharded_param = param_data.new_zeros(padded_sharded_size)
self.padded_sharded_param_size = padded_sharded_param.size()
if sharded_param.numel() > 0:
padded_sharded_param[: sharded_param.size(0)].copy_(sharded_param)
if self.offload_to_cpu and not padded_sharded_param.is_meta:
padded_sharded_param = padded_sharded_param.cpu()
if self.pin_memory:
padded_sharded_param = padded_sharded_param.pin_memory()
self._sharded_param_data = padded_sharded_param.view(-1)
self.sharded_param = nn.Parameter(
self.to_sharded_dtensor(padded_sharded_param[: sharded_param.size(0)])
)
self.sharded_param.requires_grad_(param.requires_grad)
# Let `param_data` be freed normally when its ref count reaches 0 when
# the `fully_shard` call returns to allow provided parameters to alias
self._setattr_on_modules(self.sharded_param)
self.sharded_state = ShardedState.SHARDED
def _init_sharded_post_forward_param_metadata(self, param: torch.Tensor) -> None:
mesh_info = self.post_forward_mesh_info
assert mesh_info is not None # mypy
param_data = param._local_tensor if isinstance(param, DTensor) else param
chunks = _chunk_with_empty(param_data, mesh_info.shard_mesh_size, dim=0)
self.sharded_post_forward_size = _get_dim0_chunked_size(
chunks[mesh_info.shard_mesh_rank], param_data.size()
)
self.contiguous_sharded_post_forward_stride = make_contiguous_strides_for(
self.sharded_post_forward_size
)
def init_dtype_attrs(self, mp_policy: MixedPrecisionPolicy):
param_dtype, reduce_dtype = (mp_policy.param_dtype, mp_policy.reduce_dtype)
self.orig_dtype = self.sharded_param.dtype
# Clamp `param_dtype` to `None` if no casting is required
if param_dtype == self.orig_dtype:
param_dtype = None
self.param_dtype = param_dtype
self.reduce_dtype = reduce_dtype
# None indicates that the mixed precision is not enabled
def _init_extensions(self) -> None:
inner_tensor = self._sharded_local_tensor
has_fsdp_pre_all_gather = hasattr(inner_tensor, "fsdp_pre_all_gather")
has_fsdp_post_all_gather = hasattr(inner_tensor, "fsdp_post_all_gather")
if has_fsdp_pre_all_gather != has_fsdp_post_all_gather:
raise AssertionError(
"Both fsdp_pre_all_gather and fsdp_post_all_gather should be defined "
f"if using all-gather extensions: {inner_tensor}"
)
if has_fsdp_pre_all_gather:
if self.padded_sharded_param_size != self._sharded_local_tensor.size():
raise NotImplementedError(
"FSDP all-gather extensions require even sharding on dim-0.\n"
f"{self._orig_size} is not divisible by FSDP world size {self.mesh_info.mesh.size()}."
)
self._extensions_data = ExtensionsData()
self._unsharded_inner_tensors: List[torch.Tensor] = []
def init_all_gather_outputs(
self,
all_gather_input_numels: List[int],
all_gather_input_dtypes: List[torch.dtype],
world_size: int,
device: torch.device,
):
if self.all_gather_outputs:
return # already initialized
self.all_gather_outputs = [
torch.empty(torch.Size([numel * world_size]), dtype=dtype, device=device)
for numel, dtype in zip(all_gather_input_numels, all_gather_input_dtypes)
]
def init_unsharded_param(self):
if hasattr(self, "_unsharded_param"): # after the 1st all-gather
inner_tensor = self._sharded_local_tensor
if not hasattr(inner_tensor, "fsdp_post_all_gather"):
return # already initialized
for tensor in self._unsharded_inner_tensors:
alloc_storage(tensor)
all_gather_outputs = self._unflatten_all_gather_outputs()
inner_tensor.fsdp_post_all_gather(
all_gather_outputs,
self._extensions_data.all_gather_metadata,
self.param_dtype or self.orig_dtype,
out=self._unsharded_param,
)
self._extensions_data.clear()
return
inner_tensor = self._sharded_local_tensor
if hasattr(inner_tensor, "fsdp_post_all_gather"):
all_gather_outputs = self._unflatten_all_gather_outputs()
(
unsharded_tensor,
self._unsharded_inner_tensors,
) = inner_tensor.fsdp_post_all_gather(
all_gather_outputs,
self._extensions_data.all_gather_metadata,
self.param_dtype or self.orig_dtype,
)
self._extensions_data.clear()
else:
# For the default path (no post-all-gather), the all-gather output
# gives the unsharded parameter data directly
assert len(self.all_gather_outputs) == 1, f"{len(self.all_gather_outputs)}"
unsharded_tensor = self.all_gather_outputs[0]
unsharded_param = torch.as_strided(
unsharded_tensor,
self._orig_size,
make_contiguous_strides_for(self._orig_size),
storage_offset=0,
)
if self.is_dtensor:
unsharded_param = _from_local_no_grad(
unsharded_param,
self._tp_spec.mesh,
self._tp_spec.placements,
self._global_size,
self._global_stride,
)
self._unsharded_param = nn.Parameter(unsharded_param)
self._unsharded_param.requires_grad_(self.sharded_param.requires_grad)
def _unflatten_all_gather_outputs(self) -> Tuple[torch.Tensor, ...]:
return tuple(
t.view(-1, *s[1:])
for t, s in zip(
self.all_gather_outputs, self._extensions_data.all_gather_input_sizes
)
)
def to_sharded(self) -> None:
self._setattr_on_modules(self.sharded_param)
self.free_unsharded_param()
self.sharded_state = ShardedState.SHARDED
def to_sharded_post_forward(self) -> None:
if self.is_dtensor:
raise NotImplementedError(
"Resharding to smaller mesh with TP is not supported yet"
)
self._assert_in_states(ShardedState.UNSHARDED)
assert self.post_forward_mesh_info is not None # mypy
assert len(self.all_gather_outputs) == 1
shard_world_size = self.post_forward_mesh_info.shard_mesh_size
if (numel := self.all_gather_outputs[0].numel()) % shard_world_size != 0:
_raise_assert_with_print(
f"All-gather output size ({numel}) must be divisible by the shard "
f"world size ({shard_world_size})"
)
shard_rank = self.post_forward_mesh_info.shard_mesh_rank
sharded_numel = numel // shard_world_size
self._sharded_post_forward_param_data = (
self.all_gather_outputs[0].narrow(
0, sharded_numel * shard_rank, sharded_numel
)
).clone() # clone to be able to free all-gather output
sharded_post_forward_tensor = torch.as_strided(
self._sharded_post_forward_param_data,
size=self.sharded_post_forward_size,
stride=self.contiguous_sharded_post_forward_stride,
storage_offset=0,
)
self._sharded_post_forward_param = nn.Parameter(
self.to_sharded_post_forward_dtensor(sharded_post_forward_tensor)
)
self._setattr_on_modules(self._sharded_post_forward_param)
self.free_unsharded_param()
self.sharded_state = ShardedState.SHARDED_POST_FORWARD
def to_unsharded(self) -> None:
# Assume that the data has been allocated and all-gathered
set_requires_grad_if_needed(self.sharded_param, self._unsharded_param)
self._setattr_on_modules(self._unsharded_param)
if self.sharded_state == ShardedState.SHARDED_POST_FORWARD:
# The data is allocated in the default stream via the post-forward
# reshard and must be kept alive for the next all-gather copy-in.
# Since we call this method after the copy-out, the data's lifetime
# is ensured without further synchronization.
self._sharded_post_forward_param = None
self._sharded_post_forward_param_data = None # free
self.sharded_state = ShardedState.UNSHARDED
def _setattr_on_modules(self, param: nn.Parameter) -> None:
unsafe_setattr_param(
self._module_info.module, self._module_info.param_name, param
)
for shared_module, shared_param_name in zip(
self._module_info.shared_modules, self._module_info.shared_param_names
):
unsafe_setattr_param(shared_module, shared_param_name, param)
def to_sharded_dtensor(self, tensor: torch.Tensor) -> DTensor:
"""
Converts a local tensor representing either the sharded parameter or
sharded gradient to DTensor.
"""
if tensor.shape != self.sharded_size:
_raise_assert_with_print(
f"Expects size {self.sharded_size} but got {tensor.shape}"
)
return _from_local_no_grad(
tensor,
self._global_mesh,
self._global_placements,
self._global_size,
self._global_stride,
)
def to_sharded_post_forward_dtensor(self, tensor: torch.Tensor) -> DTensor:
if tensor.shape != self.sharded_post_forward_size:
_raise_assert_with_print(
f"Expects size {self.sharded_post_forward_size} but got {tensor.shape}"
)
assert isinstance(self.post_forward_mesh_info, HSDPMeshInfo)
# TODO: Prefer this DTensor to be read-only and generalize the
# placement once we support TP.
return _from_local_no_grad(
tensor,
self.post_forward_mesh_info.mesh,
(Replicate(), Shard(0)),
self._global_size,
self._global_stride,
)
def to_accumulated_grad_if_needed(self) -> None:
# Access `_unsharded_param` to bypass the sharded state check since we
# prefer to reshard before upcasting the gradient to save memory
if (
self.reduce_dtype is None
or self._unsharded_param.grad is None
or self._unsharded_param.grad.dtype == self.reduce_dtype
):
return
unsharded_grad = self._unsharded_param.grad
self._unsharded_param.grad = None
self.unsharded_accumulated_grad = unsharded_grad.to(self.reduce_dtype)
def accumulate_unsharded_grad_if_needed(self) -> None:
if (
self.unsharded_accumulated_grad is not None
and self.unsharded_param.grad is not None
):
self.unsharded_accumulated_grad += self.unsharded_param.grad
self.unsharded_param.grad = None
def alloc_all_gather_outputs(self) -> None:
for tensor in self.all_gather_outputs:
alloc_storage(tensor)
def free_unsharded_param(self) -> None:
for tensor in itertools.chain(
self.all_gather_outputs, self._unsharded_inner_tensors
):
free_storage(tensor)
@property
def all_gather_inputs(self) -> List[torch.Tensor]: # 1D
self._assert_in_states(ShardedState.SHARDED, ShardedState.SHARDED_POST_FORWARD)
if self.sharded_state == ShardedState.SHARDED:
if hasattr(self._sharded_local_tensor, "fsdp_pre_all_gather"):
sharded_local_tensor = self._sharded_local_tensor
if self.offload_to_cpu:
sharded_local_tensor = sharded_local_tensor.to(
self.device, non_blocking=True
)
(
all_gather_inputs,
self._extensions_data.all_gather_metadata,
) = sharded_local_tensor.fsdp_pre_all_gather(self.mesh_info.mesh)
self._extensions_data.all_gather_input_sizes = [
t.size() for t in all_gather_inputs
]
return [t.view(-1) for t in all_gather_inputs]
sharded_param_data = self._sharded_param_data
if self.offload_to_cpu:
sharded_param_data = sharded_param_data.to(
self.device, non_blocking=True
)
return [_to_dtype_if_needed(sharded_param_data, self.param_dtype)]
elif self.sharded_state == ShardedState.SHARDED_POST_FORWARD:
if hasattr(self._sharded_local_tensor, "fsdp_pre_all_gather"):
raise NotImplementedError
all_gather_input = _to_dtype_if_needed(
cast(torch.Tensor, self._sharded_post_forward_param_data),
self.param_dtype,
)
return [all_gather_input]
return [torch.empty(0)] # mypy
@property
def unsharded_param(self) -> nn.Parameter: # ND
self._assert_in_states(ShardedState.UNSHARDED)
return self._unsharded_param
@property
def unsharded_grad_data(self) -> torch.Tensor:
grad = self.unsharded_param.grad
assert grad is not None, "Expects unsharded_param.grad to not be None"
return self._get_grad_inner_tensor(grad)
@property
def unsharded_accumulated_grad_data(self) -> torch.Tensor:
grad = self.unsharded_accumulated_grad
assert grad is not None, "Expects unsharded_accumulated_grad to not be None"
return self._get_grad_inner_tensor(grad)
def _get_grad_inner_tensor(self, grad: torch.Tensor) -> torch.Tensor:
if self.is_dtensor:
if isinstance(grad, AsyncCollectiveTensor):
grad = grad.wait()
assert isinstance(grad, DTensor), f"{type(grad)}"
if any(pl.is_partial() for pl in grad.placements):
placements = [
Replicate() if pl.is_partial() else pl for pl in grad.placements
]
grad = grad.redistribute(placements=placements)
grad = grad._local_tensor
return grad
@property
def _sharded_local_tensor(self) -> torch.Tensor:
return cast(DTensor, self.sharded_param)._local_tensor
def _assert_in_states(self, *states: ShardedState) -> None:
if self.sharded_state not in states:
_raise_assert_with_print(
f"Expects to be in one of {states}, not {self.sharded_state}"
)
def reset_sharded_param(self):
# For ops like `nn.Module._apply` or `load_state_dict(assign=True)`
# that change the sharded parameter tensor, we may need to re-pad the
# sharded local tensor and re-save the reference.
module_info = self._module_info
new_param = getattr(module_info.module, module_info.param_name)
if new_param is not self.sharded_param:
if torch.__future__.get_swap_module_params_on_conversion():
raise AssertionError(
f"Expects swap_tensors to preserve object but got {new_param} "
f"instead of {self.sharded_param}"
)
self.sharded_param = new_param
local_tensor = new_param._local_tensor
if local_tensor.is_meta:
return
padded_sharded_size = self.padded_sharded_param_size
if local_tensor.size() != padded_sharded_size:
padded_local_tensor = local_tensor.new_zeros(padded_sharded_size)
padded_local_tensor[: local_tensor.size(0)].copy_(local_tensor)
local_tensor = padded_local_tensor
if self.pin_memory and not local_tensor.is_pinned():
local_tensor = local_tensor.cpu().pin_memory()
self._sharded_param_data = local_tensor.view(-1)
assert isinstance(self.sharded_param, DTensor) # mypy
self.sharded_param._local_tensor = local_tensor[: self.sharded_size[0]]
def alloc_storage(tensor: torch.Tensor) -> None:
size = tensor.numel() * tensor.itemsize
if (storage := tensor.untyped_storage()).size() != size:
storage.resize_(size)
def free_storage(tensor: torch.Tensor) -> None:
if (storage := tensor.untyped_storage()).size() != 0:
storage.resize_(0)
# NOTE: These bypass `nn.Module.__setattr__` checks, which incur non-trivial
# CPU overhead, if the module did not override it. For FSDP, we know we do not
# need those checks when transitioning between sharded/unsharded parameters.
def unsafe_setattr_param(
module: nn.Module, param_name: str, param: nn.Parameter
) -> None:
if getattr(module.__setattr__, "__func__", None) is nn.Module.__setattr__:
module._parameters[param_name] = param
else: # slow path
setattr(module, param_name, param)
def set_requires_grad_if_needed(
src_tensor: torch.Tensor, dst_tensor: torch.Tensor
) -> None:
# Only call `requires_grad_` if needed to avoid the Python <> C++ context
# switch overhead
if src_tensor.requires_grad != dst_tensor.requires_grad:
dst_tensor.requires_grad_(src_tensor.requires_grad)