libinephany 0.14.1__py3-none-any.whl → 0.15.1__py3-none-any.whl

libinephany/observations/observers/global_observers.py

@@ -36,7 +36,7 @@ class InitialHyperparameters(GlobalObserver):
 
         super().__init__(**kwargs)
 
-        force_skip = ["samples"]
+        force_skip = ["samples", "gradient_accumulation"]
         skip_hparams = force_skip if skip_hparams is None else skip_hparams + force_skip
         self.skip_hparams = [] if skip_hparams is None else skip_hparams
         self.pad_with = pad_with

libinephany/observations/statistic_trackers.py

@@ -213,10 +213,10 @@ class Statistic(ABC):
 
         if torch_distributed_utils.is_scheduler_master_rank():
             if isinstance(statistic, torch.Tensor):
-                shape = statistic.shape
+                shape = statistic.view(-1).shape
 
             elif isinstance(statistic, TensorStatistics):
-                shape = statistic.to_tensor().shape
+                shape = statistic.to_tensor().view(-1).shape
 
             elif statistic is not None:
                 shape = torch.tensor([statistic]).shape
@@ -239,23 +239,21 @@ class Statistic(ABC):
         if not torch_distributed_utils.is_distributed():
             return statistic
 
-        if statistic is None:
-            shape = self._determine_reduction_shape(statistic=statistic)
-
-            if shape is None:
-                return statistic
+        shape = self._determine_reduction_shape(statistic=statistic)
 
-            to_reduce = torch.zeros(shape)
+        if statistic is None:
+            to_reduce = torch.zeros(shape, dtype=torch.float64)
 
         elif isinstance(statistic, torch.Tensor):
-            to_reduce = statistic.clone()
+            to_reduce = statistic.clone().to(torch.float64).view(-1)
 
         elif isinstance(statistic, TensorStatistics):
-            to_reduce = statistic.to_tensor()
+            to_reduce = statistic.to_tensor().to(torch.float64).view(-1)
 
         else:
-            to_reduce = torch.tensor([statistic])
+            to_reduce = torch.tensor([statistic], dtype=torch.float64)
 
+        to_reduce = to_reduce.to(torch_distributed_utils.get_local_device())
         dist.reduce(to_reduce, dst=MASTER_SCHEDULER_RANK, op=ReduceOp.SUM)
 
         if not torch_distributed_utils.is_scheduler_master_rank():
@@ -283,11 +281,13 @@ class Statistic(ABC):
 
         parameter_group = self._find_parameter_group(optimizer=optimizer)
         parameters = self._get_parameters(parameter_group=parameter_group)
+        self._sample_number += 1
 
         if self._sample_number % self.sample_frequency == 0:
             statistic = self._gather(
                 optimizer=optimizer, model=model, parameters=parameters, parameter_group=parameter_group
             )
+
             statistic = self._distributed_reduce(statistic=statistic)
 
             if not torch_distributed_utils.is_scheduler_master_rank():
@@ -303,9 +303,6 @@ class Statistic(ABC):
             elif statistic is not None:
                 self._data.append(statistic)  # type: ignore
 
-        if torch_distributed_utils.is_scheduler_master_rank():
-            self._sample_number += 1
-
     @final
     def fetch(self) -> TensorStatistics | float | None:
         """

libinephany/pydantic_models/configs/hyperparameter_configs.py

@@ -4,7 +4,7 @@
 #
 # ======================================================================================================================
 
-from typing import Any
+from typing import Any, cast
 
 from pydantic import BaseModel, ConfigDict, ValidationError, field_serializer, field_validator, model_validator
 
@@ -232,6 +232,23 @@ class BatchSizeHParamConfig(HParamConfig):
     sample_discrete_values: list[float | int] | None = None
 
 
+class GradientAccumulationHParamConfig(HParamConfig):
+    max_hparam_value: float | int = 64
+    min_hparam_value: float | int = 1
+    hparam_dtype: type[float | int] = int
+    initial_value: int = 1
+    initial_delta: float = 0.0
+    scale: float = 1.0
+
+    sampler: str = "DiscreteRangeSampler"
+    sample_initial_values: bool = False
+    sample_lower_bound: int = 1
+    sample_upper_bound: int = 64
+    sample_step: int = 1
+    sample_discrete_values: list[float | int] | None = None
+    force_limit: float | int = 64
+
+
 class EpochsHParamConfig(HParamConfig):
     max_hparam_value: float | int = 16
     min_hparam_value: float | int = 1
@@ -289,6 +306,7 @@ class HParamConfigs(BaseModel):
     sgd_momentum_config: HParamConfig = SGDMomentumHParamConfig()
 
     batch_size_config: HParamConfig = BatchSizeHParamConfig()
+    gradient_accumulation_config: GradientAccumulationHParamConfig = GradientAccumulationHParamConfig()
     epochs_config: HParamConfig = EpochsHParamConfig()
     token_config: HParamConfig = TokensHParamConfig()
     samples_config: HParamConfig = SamplesHParamConfig()
@@ -351,6 +369,9 @@ class HParamConfigs(BaseModel):
             case AgentTypes.BatchSize:
                 self.batch_size_config = hparam_config
 
+            case AgentTypes.GradientAccumulationAgent:
+                self.gradient_accumulation_config = cast(GradientAccumulationHParamConfig, hparam_config)
+
             case AgentTypes.Epochs:
                 self.epochs_config = hparam_config
 
@@ -400,6 +421,9 @@ class HParamConfigs(BaseModel):
             case AgentTypes.BatchSize:
                 return self.batch_size_config
 
+            case AgentTypes.GradientAccumulationAgent:
+                return self.gradient_accumulation_config
+
             case AgentTypes.Epochs:
                 return self.epochs_config
 

libinephany/pydantic_models/schemas/inner_task_profile.py

@@ -140,6 +140,40 @@ class InnerTaskProfiles(BaseModel):
 
         return sum(self.compiled_action_sizes.values())
 
+    @property
+    def max_total_observation_size(self) -> int:
+        """
+        :return: The summed observation size of all agents with the task that has the most layers.
+        """
+
+        if not self.profiles:
+            raise ValueError(
+                "No profiles to calculate max total observation size. Ensure profiles have been "
+                "added before executing the training loop"
+            )
+
+        largest_task_name = max(self.profiles, key=lambda k: self.profiles[k].number_of_layers)
+        largest_task = self.profiles[largest_task_name]
+
+        return sum(largest_task.observation_space_sizes.values())
+
+    @property
+    def max_total_action_size(self) -> int:
+        """
+        :return: The summed action size of all agents with the task that has the most layers.
+        """
+
+        if not self.profiles:
+            raise ValueError(
+                "No profiles to calculate max total action size. Ensure profiles have been "
+                "added before executing the training loop"
+            )
+
+        largest_task_name = max(self.profiles, key=lambda k: self.profiles[k].number_of_layers)
+        largest_task = self.profiles[largest_task_name]
+
+        return sum(largest_task.action_space_sizes.values())
+
     @staticmethod
     def _compile_gym_space_sizes(spaces: dict[str, dict[str, int]]) -> dict[str, int]:
         """

libinephany/pydantic_models/states/hyperparameter_states.py

@@ -20,6 +20,7 @@ from libinephany.utils.constants import (
     DROPOUT,
     EPOCHS,
     GRAD_NORM_CLIP,
+    GRADIENT_ACCUMULATION,
     LEARNING_RATE,
     SAMPLES,
     SGD_MOMENTUM,
@@ -60,6 +61,7 @@ class UpdateCallbacks(BaseModel):
     sgd_momentum: Callable[..., None]
 
     batch_size: Callable[..., None] | None
+    gradient_accumulation: Callable[..., None] | None
     epochs: Callable[..., None] | None
 
     def __getitem__(self, item: str) -> Callable[..., None] | None:
@@ -457,6 +459,7 @@ class ParameterGroupHParams(HyperparameterContainer):
 class GlobalHParams(HyperparameterContainer):
 
     batch_size: Hyperparameter
+    gradient_accumulation: Hyperparameter
     epochs: Hyperparameter
     tokens: Hyperparameter
     samples: Hyperparameter
@@ -550,6 +553,14 @@ class HyperparameterStates(BaseModel):
         """
         return self.global_hparams.batch_size
 
+    @computed_field  # type: ignore[misc]
+    @property
+    def gradient_accumulation(self) -> Hyperparameter:
+        """
+        :return: The gradient accumulation steps of the inner model.
+        """
+        return self.global_hparams.gradient_accumulation
+
     @computed_field  # type: ignore[misc]
     @property
     def epochs(self) -> Hyperparameter:
@@ -676,6 +687,7 @@ class HyperparameterStates(BaseModel):
 
         return {
             BATCH_SIZE: hparam_configs.batch_size_config,
+            GRADIENT_ACCUMULATION: hparam_configs.gradient_accumulation_config,
             EPOCHS: hparam_configs.epochs_config,
             TOKENS: hparam_configs.token_config,
             SAMPLES: hparam_configs.samples_config,

libinephany/utils/constants.py

@@ -21,6 +21,7 @@ ADAM_BETA_TWO = "adam_beta_two"
 ADAM_EPS = "adam_eps"
 SGD_MOMENTUM = "sgd_momentum"
 BATCH_SIZE = "batch_size"
+GRADIENT_ACCUMULATION = "gradient_accumulation"
 EPOCHS = "epochs"
 TOKENS = "tokens"
 SAMPLES = "samples"
@@ -41,6 +42,7 @@ AGENT_PREFIX_EPS = "adam-eps"
 AGENT_PREFIX_SGD_MOMENTUM = "sgd-momentum"
 
 AGENT_BATCH_SIZE = "batch-size"
+AGENT_GRADIENT_ACCUMULATION = "gradient-accumulation"
 
 AGENT_BANDIT_SUFFIX = "bandit-agent"
 
@@ -53,6 +55,7 @@ AGENT_TYPES = [
     ADAM_BETA_TWO,
     ADAM_EPS,
     SGD_MOMENTUM,
+    GRADIENT_ACCUMULATION,
 ]
 SUFFIXES = [AGENT_BANDIT_SUFFIX]
 PREFIXES = [
@@ -64,6 +67,7 @@ PREFIXES = [
     AGENT_PREFIX_BETA_TWO,
     AGENT_PREFIX_EPS,
     AGENT_PREFIX_SGD_MOMENTUM,
+    AGENT_GRADIENT_ACCUMULATION,
 ]
 PREFIXES_TO_HPARAMS = {
     AGENT_PREFIX_LR: LEARNING_RATE,
@@ -74,4 +78,5 @@ PREFIXES_TO_HPARAMS = {
     AGENT_PREFIX_BETA_TWO: ADAM_BETA_TWO,
     AGENT_PREFIX_EPS: ADAM_EPS,
     AGENT_PREFIX_SGD_MOMENTUM: SGD_MOMENTUM,
+    AGENT_GRADIENT_ACCUMULATION: GRADIENT_ACCUMULATION,
 }

libinephany/utils/enums.py

@@ -14,6 +14,7 @@ from libinephany.utils.constants import (
     DROPOUT,
     EPOCHS,
     GRAD_NORM_CLIP,
+    GRADIENT_ACCUMULATION,
     LEARNING_RATE,
     SAMPLES,
     SGD_MOMENTUM,
@@ -69,6 +70,7 @@ class AgentTypes(EnumWithIndices):
     AdamBetaTwoAgent = ADAM_BETA_TWO
     AdamEpsAgent = ADAM_EPS
     SGDMomentumAgent = SGD_MOMENTUM
+    GradientAccumulationAgent = GRADIENT_ACCUMULATION
 
     # Deprecated or Non-Agent
     BatchSize = BATCH_SIZE

libinephany/utils/torch_distributed_utils.py

@@ -4,8 +4,10 @@
 #
 # ======================================================================================================================
 
+import os
 from typing import Any
 
+import torch
 import torch.distributed as dist
 
 # ======================================================================================================================
@@ -14,7 +16,11 @@ import torch.distributed as dist
 #
 # ======================================================================================================================
 
+CUDA = "cuda"
+CPU = "cpu"
+CUDA_PREFIX = f"{CUDA}:"
 MASTER_SCHEDULER_RANK = 0
+LOCAL_RANK = "LOCAL_RANK"
 
 # ======================================================================================================================
 #
@@ -48,7 +54,10 @@ def get_local_rank() -> int:
     :return: Distributed computing rank of this process.
     """
 
-    return dist.get_rank() if is_distributed() else MASTER_SCHEDULER_RANK
+    if not is_distributed():
+        return MASTER_SCHEDULER_RANK
+
+    return dist.get_rank()
 
 
 def is_scheduler_master_rank() -> bool:
@@ -83,3 +92,15 @@ def barrier() -> None:
 
     if is_distributed():
         dist.barrier()
+
+
+def get_local_device() -> torch.device:
+    """
+    :return: Local device of the current rank.
+    """
+
+    if not is_distributed():
+        return torch.device(CUDA if torch.cuda.is_available() else CPU)
+
+    local_device_rank = os.environ.get(LOCAL_RANK, MASTER_SCHEDULER_RANK)
+    return torch.device(f"{CUDA_PREFIX}{local_device_rank}" if torch.cuda.is_available() else CPU)

{libinephany-0.14.1.dist-info → libinephany-0.15.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libinephany
-Version: 0.14.1
+Version: 0.15.1
 Summary: Inephany library containing code commonly used by multiple subpackages.
 Author-email: Inephany <info@inephany.com>
 License: Apache 2.0

{libinephany-0.14.1.dist-info → libinephany-0.15.1.dist-info}/RECORD

@@ -6,36 +6,36 @@ libinephany/observations/observation_utils.py,sha256=wb6EZiaEiPuOqN26zzuT1rHyeho
 libinephany/observations/observer_pipeline.py,sha256=ZhONGXJQSgs2VJJn9d2F7ItkYqntvchl9-JTyxW9eU0,12146
 libinephany/observations/pipeline_coordinator.py,sha256=FrN3linKaC0pVE5uKjlh_0Fi8Mb1oK91NzH3Fq7PvyM,7420
 libinephany/observations/statistic_manager.py,sha256=LLg1zSxnJr2oQQepYla3qoUuRy10rsthr9jta4wEbnc,8956
-libinephany/observations/statistic_trackers.py,sha256=flkXquMHvY6YjnQAvRElsV5OUm7Ek_PhA1_fvtX-0oQ,30124
+libinephany/observations/statistic_trackers.py,sha256=J444i9EZ30vcYOEYqcDBzz7_UDpEE2hW_ISYBu_hwYc,30180
 libinephany/observations/observers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 libinephany/observations/observers/base_observers.py,sha256=RkG5SW0b6Ooy0_oscRHxyB_YFNP7k8fxu37jBZElxIM,15418
-libinephany/observations/observers/global_observers.py,sha256=-BJJaYjQSO82qskIlY_iijd3Lk1Ei1d3Hg1fzmYUPSM,38659
+libinephany/observations/observers/global_observers.py,sha256=3TaiV2AxMOXfDq-kXMU3ZSo-rQENNCFhdWCJtpY99ok,38684
 libinephany/observations/observers/local_observers.py,sha256=EdivrylOcmxRsu4xiMwZqwmPX8Ru9-IRwoPk6En7qvw,37050
 libinephany/observations/observers/observer_containers.py,sha256=g73ScbRRVTNbGEBb-Nyk8AQwoDhKZaqTd6OYP8FIcOs,8771
 libinephany/observations/post_processors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 libinephany/observations/post_processors/postprocessors.py,sha256=43_e5UaDPr2KbAvqc_w3wLqnlm7bgRjqgCtyQ95-8cM,5913
 libinephany/pydantic_models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 libinephany/pydantic_models/configs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-libinephany/pydantic_models/configs/hyperparameter_configs.py,sha256=5BH7aPiFtSfhTKp-Z0WTbCYuGJvUTskgFgMttxpDZb0,13654
+libinephany/pydantic_models/configs/hyperparameter_configs.py,sha256=FYl8A2_9L-ohg36aZEW5kREO3tcqIyztYpW62s99tqY,14562
 libinephany/pydantic_models/configs/observer_config.py,sha256=v_ChzaVXC_rlZ7eDZPuCae1DdG7-PS3mPwC-OaWpGQo,1355
 libinephany/pydantic_models/configs/outer_model_config.py,sha256=GQ0QBSC2Xht8x8X_TEMfYM2GF_x1kErLuFrA_H6Jhs0,1209
 libinephany/pydantic_models/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 libinephany/pydantic_models/schemas/agent_info.py,sha256=me5gDxvZjP9TNK588mpUvxiiJrPDqy3Z7ZHRzryAYTs,2628
-libinephany/pydantic_models/schemas/inner_task_profile.py,sha256=wgclLbDqDjuk-_v2f66Eb6btf3RDzz6leCZvSthQde4,10464
+libinephany/pydantic_models/schemas/inner_task_profile.py,sha256=Xu0tQmhGwV043tTamFiHekuE1RRXhhrUrGbtymjXo7g,11722
 libinephany/pydantic_models/schemas/observation_models.py,sha256=YjQmrWZ0r-_LRp92jvhSD8p1grKsMVXCXoou4q15Ue8,1849
 libinephany/pydantic_models/schemas/request_schemas.py,sha256=VED8eAUvBofxeAx9gWU8DyCZOTVD3QsHRq-TO7kyOqk,1260
 libinephany/pydantic_models/schemas/response_schemas.py,sha256=SKFuasdjX5aH_I0vT3SwnpwhyMf9cNPB1ZpDeAGgoO8,2158
 libinephany/pydantic_models/schemas/tensor_statistics.py,sha256=Z-x-Fi_Dm0pLoHI88DnJO1krY671o0zbGRzx-gXPtVY,7534
 libinephany/pydantic_models/states/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-libinephany/pydantic_models/states/hyperparameter_states.py,sha256=JWNSmQmncnQu2GTh0MeT8pvPLxttyrhsKXErucdURqQ,32223
+libinephany/pydantic_models/states/hyperparameter_states.py,sha256=fwqUmRbT5WxcnMPK8DmRXkBQOtCs9n6V24BeCyFTFL8,32688
 libinephany/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 libinephany/utils/agent_utils.py,sha256=_2w1AY5Y4mQ5hes_Rq014VhZXOtIOn-W92mZgeixv3g,2658
 libinephany/utils/asyncio_worker.py,sha256=Ew23zKIbG1zwyCudcyiObMrw4G0f3p2QXzZfM4mePqI,2751
 libinephany/utils/backend_statuses.py,sha256=ZbpBPbz0qKmeqxyGGN_ePTrQ7Wrxh7KM6W26UDbPXtQ,644
-libinephany/utils/constants.py,sha256=RH-0fZe6SL1WrrsrW4KP4k7ClQZDq8IFEdok3hEnRt4,1952
+libinephany/utils/constants.py,sha256=piawYQa51vCxxAHCH3YoWOgUhTlgqgQxKMCenkoQTsc,2170
 libinephany/utils/directory_utils.py,sha256=408unVeE_5_Hm-ZYZuxc9sdvfuU0CgYELX7EzPlPieo,1217
 libinephany/utils/dropout_utils.py,sha256=X43yCW7Dh1cC5sNnivgS5j1fn871K_RCvxCBTT0YHKg,3392
-libinephany/utils/enums.py,sha256=YH10mUhW4kjYS0cp4XUASok9vfPl0jv9ZhS3HpZD0Zg,2339
+libinephany/utils/enums.py,sha256=kEECkJO2quKAyVAqzgOzOP-d4qIENE3z_RyymSvyIB8,2420
 libinephany/utils/error_severities.py,sha256=B9oidqOVaYOe0W6P6GwjpmuDsrkyTX30v1xdiUStCFk,1427
 libinephany/utils/exceptions.py,sha256=kgwLpHOgy3kciUz_I18xnYsWRtzdonfadUtwG2uDYk8,1823
 libinephany/utils/import_utils.py,sha256=WzC6V6UIa0nCiU2MekROwG82fWBh9RuVzichtby5EvM,1495
@@ -43,15 +43,15 @@ libinephany/utils/optim_utils.py,sha256=-PLqsyuq4ZH3spBy_olNB3yuLwvhnLrCF0384elC
 libinephany/utils/random_seeds.py,sha256=eF-ErrMShu8mp9V_gXrB_iUxR-Lb-OtHypEEUQAGn2Y,1565
 libinephany/utils/samplers.py,sha256=uyVGAy5cm5bCyWMOuySJmzUc_vFuieO_3zydJciwdv4,12158
 libinephany/utils/standardizers.py,sha256=pG1K_XL4OR_NjVtT6Hjbln1dk1BtQdDuSK1PQTkA17Y,8014
-libinephany/utils/torch_distributed_utils.py,sha256=ygdVz-s7hMRoBJcZkNRBlF81MYnxoRJt8S0SAwq6SC4,2467
+libinephany/utils/torch_distributed_utils.py,sha256=UPMfhdZZwyHX_r3h55AAK4PcB-zFtjK37Z5aawAKNmE,2968
 libinephany/utils/torch_utils.py,sha256=o5TsqrXe6Id04P6SqB_avGBRZutbu6IBB61llAHQ_PY,2696
 libinephany/utils/transforms.py,sha256=Ca4pbCs_FbCpXb8M8oPxrP5QOqOAwGSdGpKzy5YUubc,3503
 libinephany/utils/typing.py,sha256=rGbaPO3MaUndsWiC_wHzReD_TOLYqb43i01pKN-j7Xs,624
 libinephany/web_apps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 libinephany/web_apps/error_logger.py,sha256=gAQIaqerqP4ornXZwFF1cghjnd2mMZEt3aVrTuUCr34,16653
 libinephany/web_apps/web_app_utils.py,sha256=qiq_lasPipgN1RgRudPJc342kYci8O_4RqppxmIX8NY,4095
-libinephany-0.14.1.dist-info/licenses/LICENSE,sha256=pogfDoMBP07ehIOvWymuWIar8pg2YLUhqOHsJQU3wdc,9250
-libinephany-0.14.1.dist-info/METADATA,sha256=k82YNw3190axmX8DPGPpYHSChw5nvJojLns-JNAhXw8,8354
-libinephany-0.14.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-libinephany-0.14.1.dist-info/top_level.txt,sha256=bYAOXQdJgIoLkO2Ui0kxe7pSYegS_e38u0dMscd7COQ,12
-libinephany-0.14.1.dist-info/RECORD,,
+libinephany-0.15.1.dist-info/licenses/LICENSE,sha256=pogfDoMBP07ehIOvWymuWIar8pg2YLUhqOHsJQU3wdc,9250
+libinephany-0.15.1.dist-info/METADATA,sha256=lsqYtqyJ_k_clascJkzx8rR7gEN75tZ8lCKNqcH1cps,8354
+libinephany-0.15.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+libinephany-0.15.1.dist-info/top_level.txt,sha256=bYAOXQdJgIoLkO2Ui0kxe7pSYegS_e38u0dMscd7COQ,12
+libinephany-0.15.1.dist-info/RECORD,,