Precision

class lightning_fabric.plugins.precision.Precision[source]

Bases: object

Base class for all plugins handling the precision-specific parts of the training.

The class attribute precision must be overwritten in child classes. The default value reflects fp32 training.

backward(tensor, model, *args, **kwargs)[source]

Performs the actual backpropagation.

Parameters

• tensor (Tensor) – The tensor that will be used for backpropagation

• model (Optional[Module]) – The module that was involved in producing the tensor and whose parameters need the gradients

Return type

None

convert_input(data)[source]

Convert model inputs (forward) to the floating point precision type of this plugin.

This is a no-op for tensors that are not of floating-point type or already have the desired type.

Return type

Tensor

convert_module(module)[source]

Convert the module parameters to the precision type this plugin handles.

This is optional and depends on the precision limitations during optimization.

Return type

Module

forward_context()[source]

A contextmanager for managing model forward/training_step/evaluation_step/predict_step.

Return type

Generator[None, None, None]

load_state_dict(state_dict)[source]

Called when loading a checkpoint, implement to reload precision plugin state given precision plugin state_dict.

Parameters

state_dict (Dict[str, Any]) – the precision plugin state returned by state_dict.

Return type

None

main_params(optimizer)[source]

The main params of the model.

Returns the plain model params here. Maybe different in other precision plugins.

Return type

Iterator[Parameter]

optimizer_step(optimizer, **kwargs)[source]

Hook to run the optimizer step.

Return type

Any

post_backward(tensor, module)[source]

Runs after precision plugin executes backward.

Parameters

• tensor (Tensor) – The tensor that will be used for backpropagation

• module (Optional[Module]) – The module that was involved in producing the tensor and whose parameters need the gradients

Return type

Any

pre_backward(tensor, module)[source]

Runs before precision plugin executes backward.

Parameters

• tensor (Tensor) – The tensor that will be used for backpropagation

• module (Optional[Module]) – The module that was involved in producing the tensor and whose parameters need the gradients

Return type

Any

state_dict()[source]

Called when saving a checkpoint, implement to generate precision plugin state_dict.

Return type

Dict[str, Any]

Returns

A dictionary containing precision plugin state.

teardown()[source]

This method is called to teardown the training process.

It is the right place to release memory and free other resources.

Return type

None