brainstate 0.0.1.1.post20240708__py2.py3-none-any.whl → 0.0.1.1.post20240804__py2.py3-none-any.whl

brainstate/_module.py

@@ -61,11 +61,9 @@ from ._state import State, StateDictManager, visible_state_dict
 from ._utils import set_module_as
 from .mixin import Mixin, Mode, DelayedInit, JointTypes, Batching, UpdateReturn
 from .transform import jit_error
+from .typing import Size, ArrayLike, PyTree
 from .util import unique_name, DictManager, get_unique_name
 
-Shape = Union[int, Sequence[int]]
-PyTree = Any
-ArrayLike = jax.typing.ArrayLike
 
 delay_identifier = '_*_delay_of_'
 _DELAY_ROTATE = 'rotation'
@@ -805,7 +803,7 @@ class Dynamics(ExtendedUpdateWithBA, ReceiveInputProj, UpdateReturn):
 
   def __init__(
       self,
-      size: Shape,
+      size: Size,
       keep_size: bool = False,
       name: Optional[str] = None,
       mode: Optional[Mode] = None,
@@ -1275,25 +1273,25 @@ class Delay(ExtendedUpdateWithBA, DelayedInit):
 
     if self.interp_method == _INTERP_LINEAR:  # "linear" interpolation
       # def _interp(target):
-        # if len(indices) > 0:
-        #   raise NotImplementedError('The slicing indices are not supported in the linear interpolation.')
-        # if self.delay_method == _DELAY_ROTATE:
-        #   i = environ.get(environ.I, desc='The time step index.')
-        #   _interp_fun = partial(jnp.interp, period=self.max_length)
-        #   for dim in range(1, target.ndim, 1):
-        #     _interp_fun = jax.vmap(_interp_fun, in_axes=(None, None, dim), out_axes=dim - 1)
-        #   di = i - jnp.arange(self.max_length)
-        #   delay_idx = jnp.asarray(di % self.max_length, dtype=jnp.int32)
-        #   return _interp_fun(float_time_step, delay_idx, target)
-        #
-        # elif self.delay_method == _DELAY_CONCAT:
-        #   _interp_fun = partial(jnp.interp, period=self.max_length)
-        #   for dim in range(1, target.ndim, 1):
-        #     _interp_fun = jax.vmap(_interp_fun, in_axes=(None, None, dim), out_axes=dim - 1)
-        #   return _interp_fun(float_time_step, jnp.arange(self.max_length), target)
-        #
-        # else:
-        #   raise ValueError(f'Unknown delay updating method "{self.delay_method}"')
+      # if len(indices) > 0:
+      #   raise NotImplementedError('The slicing indices are not supported in the linear interpolation.')
+      # if self.delay_method == _DELAY_ROTATE:
+      #   i = environ.get(environ.I, desc='The time step index.')
+      #   _interp_fun = partial(jnp.interp, period=self.max_length)
+      #   for dim in range(1, target.ndim, 1):
+      #     _interp_fun = jax.vmap(_interp_fun, in_axes=(None, None, dim), out_axes=dim - 1)
+      #   di = i - jnp.arange(self.max_length)
+      #   delay_idx = jnp.asarray(di % self.max_length, dtype=jnp.int32)
+      #   return _interp_fun(float_time_step, delay_idx, target)
+      #
+      # elif self.delay_method == _DELAY_CONCAT:
+      #   _interp_fun = partial(jnp.interp, period=self.max_length)
+      #   for dim in range(1, target.ndim, 1):
+      #     _interp_fun = jax.vmap(_interp_fun, in_axes=(None, None, dim), out_axes=dim - 1)
+      #   return _interp_fun(float_time_step, jnp.arange(self.max_length), target)
+      #
+      # else:
+      #   raise ValueError(f'Unknown delay updating method "{self.delay_method}"')
       # return jax.tree.map(_interp, self.history.value)
 
       data_at_t0 = self.retrieve_at_step(jnp.asarray(jnp.floor(float_time_step), dtype=jnp.int32), *indices)

brainstate/_state.py

@@ -15,18 +15,16 @@
 
 import contextlib
 import threading
-from typing import Any, Tuple, Dict, List, Callable
+from typing import Any, Tuple, Dict, List, Callable, Optional
 
 import jax
 import numpy as np
 from jax.api_util import shaped_abstractify
 from jax.extend import source_info_util
 
+from .typing import ArrayLike, PyTree
 from .util import DictManager
 
-PyTree = Any
-max_int = np.iinfo(np.int32)
-
 __all__ = [
   'State', 'ShortTermState', 'LongTermState', 'ParamState',
   'StateDictManager',
@@ -36,6 +34,7 @@ __all__ = [
 ]
 
 _pytree_registered_objects = set()
+max_int = np.iinfo(np.int32)
 
 
 def _register_pytree_cls(cls):
@@ -108,9 +107,9 @@ class State(object):
     value: PyTree. It can be anything as a pyTree.
   """
   __module__ = 'brainstate'
-  __slots__ = ('_value', '_tree', '_level', '_source_info', '_check_tree')
+  __slots__ = ('_value', '_name', '_tree', '_level', '_source_info', '_check_tree')
 
-  def __init__(self, value: PyTree):
+  def __init__(self, value: PyTree[ArrayLike], name: Optional[str] = None):
     if isinstance(value, State):
       value = value.value
     self._value = value
@@ -118,9 +117,24 @@ class State(object):
     self._check_tree = False
     self._level = len(thread_local_stack.stack)
     self._source_info = source_info_util.current()
+    self._name = name
+
+  @property
+  def name(self) -> Optional[str]:
+    """
+    The name of the state.
+    """
+    return self._name
+
+  @name.setter
+  def name(self, name: str) -> None:
+    """
+    Set the name of the state.
+    """
+    self._name = name
 
   @property
-  def value(self) -> PyTree:
+  def value(self) -> PyTree[ArrayLike]:
     """
     The data and its value.
     """
@@ -210,7 +224,10 @@ class State(object):
     leaves, tree = jax.tree.flatten(self._value)
     leaves_info = [ShapeDtype(leaf.shape, leaf.dtype) for leaf in leaves]
     tree_info = jax.tree.unflatten(tree, leaves_info)
-    return f'{self.__class__.__name__}({tree_info})'
+    if self.name is None:
+      return f'{self.__class__.__name__}({tree_info})'
+    else:
+      return f'{self.__class__.__name__}({self.name}: {tree_info})'
 
 
 class ShapeDtype:

brainstate/functional/_activations.py

@@ -25,8 +25,8 @@ from typing import Any, Union, Sequence
 import jax
 import jax.numpy as jnp
 from jax.scipy.special import logsumexp
-from jax.typing import ArrayLike
 
+from brainstate.typing import ArrayLike
 from .. import random
 
 __all__ = [

brainstate/functional/_others.py

@@ -16,12 +16,11 @@
 from __future__ import annotations
 
 from functools import partial
-from typing import Any
 
 import jax
 import jax.numpy as jnp
 
-PyTree = Any
+from brainstate.typing import PyTree
 
 __all__ = [
   'clip_grad_norm',

brainstate/init/_generic.py

@@ -22,8 +22,8 @@ import jax
 import numpy as np
 
 from brainstate._state import State
+from brainstate.typing import ArrayLike
 from ._base import to_size
-from ..typing import ArrayLike
 
 __all__ = [
   'param',
@@ -83,7 +83,7 @@ def _expand_params_to_match_sizes(params, sizes):
 
 
 def param(
-    parameter: Union[Callable, ArrayLike],
+    parameter: Union[Callable, ArrayLike, State],
     sizes: Union[int, Sequence[int]],
     batch_size: Optional[int] = None,
     allow_none: bool = True,

brainstate/init/_random_inits.py

@@ -22,8 +22,8 @@ import jax.numpy as jnp
 import numpy as np
 
 from brainstate import environ, random
+from brainstate.typing import ArrayLike
 from ._base import Initializer, to_size
-from ..typing import ArrayLike
 
 __all__ = [
   'Normal',

brainstate/mixin.py

@@ -15,14 +15,15 @@
 
 # -*- coding: utf-8 -*-
 
-from typing import Sequence, Optional, TypeVar, Any
+from typing import Sequence, Optional, TypeVar
 from typing import (_SpecialForm, _type_check, _remove_dups_flatten, _UnionGenericAlias)
 
-T = TypeVar('T')
-PyTree = Any
+from .typing import PyTree
 
+T = TypeVar('T')
 State = None
 
+
 __all__ = [
   'Mixin',
   'DelayedInit',
@@ -207,7 +208,7 @@ class _JointGenericAlias(_UnionGenericAlias, _root=True):
 
 @_SpecialForm
 def JointTypes(self, parameters):
-  """All of types; AllOfTypes[X, Y] means both X and Y.
+  """Joint types; JointTypes[X, Y] means both X and Y.
 
   To define a union, use e.g. Union[int, str].
 
@@ -216,28 +217,28 @@ def JointTypes(self, parameters):
   - None as an argument is a special case and is replaced by `type(None)`.
   - Unions of unions are flattened, e.g.::
 
-      AllOfTypes[AllOfTypes[int, str], float] == AllOfTypes[int, str, float]
+      JointTypes[JointTypes[int, str], float] == JointTypes[int, str, float]
 
   - Unions of a single argument vanish, e.g.::
 
-      AllOfTypes[int] == int  # The constructor actually returns int
+      JointTypes[int] == int  # The constructor actually returns int
 
   - Redundant arguments are skipped, e.g.::
 
-      AllOfTypes[int, str, int] == AllOfTypes[int, str]
+      JointTypes[int, str, int] == JointTypes[int, str]
 
   - When comparing unions, the argument order is ignored, e.g.::
 
-      AllOfTypes[int, str] == AllOfTypes[str, int]
+      JointTypes[int, str] == JointTypes[str, int]
 
-  - You cannot subclass or instantiate a AllOfTypes.
-  - You can use Optional[X] as a shorthand for AllOfTypes[X, None].
+  - You cannot subclass or instantiate a JointTypes.
+  - You can use Optional[X] as a shorthand for JointTypes[X, None].
   """
   if parameters == ():
     raise TypeError("Cannot take a Joint of no types.")
   if not isinstance(parameters, tuple):
     parameters = (parameters,)
-  msg = "AllOfTypes[arg, ...]: each arg must be a type."
+  msg = "JointTypes[arg, ...]: each arg must be a type."
   parameters = tuple(_type_check(p, msg) for p in parameters)
   parameters = _remove_dups_flatten(parameters)
   if len(parameters) == 1:

brainstate/mixin_test.py

@@ -30,6 +30,8 @@ class TestMixin(unittest.TestCase):
     self.assertTrue(bc.mixin.Training)
 
 
+
+
 class TestMode(unittest.TestCase):
   def test_JointMode(self):
     a = bc.mixin.JointMode(bc.mixin.Batching(), bc.mixin.Training())

brainstate/nn/_elementwise.py

@@ -1139,13 +1139,13 @@ class Dropout(Module, ElementWiseBlock):
       name: Optional[str] = None
   ) -> None:
     super().__init__(mode=mode, name=name)
-    assert 0. <= prob < 1., f"Dropout probability must be in the range [0, 1). But got {prob}."
+    assert 0. <= prob <= 1., f"Dropout probability must be in the range [0, 1]. But got {prob}."
     self.prob = prob
 
   def __call__(self, x):
     dtype = bu.math.get_dtype(x)
     fit_phase = environ.get('fit', desc='Whether this is a fitting process. Bool.')
-    if fit_phase:
+    if fit_phase and self.prob < 1.:
       keep_mask = random.bernoulli(self.prob, x.shape)
       return jnp.where(keep_mask,
                        jnp.asarray(x / self.prob, dtype=dtype),

brainstate/random.py

@@ -1167,23 +1167,32 @@ def default_rng(seed_or_key=None, clone: bool = True) -> RandomState:
     return RandomState(seed_or_key)
 
 
-def seed(seed: int = None):
+def seed(seed_or_key: int = None):
   """Sets a new random seed.
 
   Parameters
   ----------
-  seed: int, optional
-    The random seed.
+  seed_or_key: int, optional
+    The random seed (an integer) or jax random key.
   """
   with jax.ensure_compile_time_eval():
-    if seed is None:
-      seed = np.random.randint(0, 100000)
-    np.random.seed(seed)
-  DEFAULT.seed(seed)
+    if seed_or_key is None:
+      seed_or_key = np.random.randint(0, 100000)
+
+  # numpy random seed
+  if np.size(seed_or_key) == 1:  # seed
+    np.random.seed(seed_or_key)
+  elif np.size(seed_or_key) == 2:  # jax random key
+    np.random.seed(seed_or_key[0])
+  else:
+    raise ValueError(f"seed_or_key should be an integer or a tuple of two integers.")
+
+  # jax random seed
+  DEFAULT.seed(seed_or_key)
 
 
 @contextmanager
-def seed_context(seed: int):
+def seed_context(seed_or_key: SeedOrKey):
   """
   A context manager that sets the random seed for the duration of the block.
 
@@ -1206,16 +1215,19 @@ def seed_context(seed: int):
      The context manager does not only set the seed for the AX random state, but also for the numpy random state.
 
   Args:
-    seed: The seed (an integer).
+    seed_or_key: The seed (an integer) or jax random key.
 
-  Returns:
-    The random state.
   """
   old_jrand_key = DEFAULT.value
   old_np_state = np.random.get_state()
   try:
-    np.random.seed(seed)
-    DEFAULT.seed(seed)
+    if np.size(seed_or_key) == 1:  # seed
+      np.random.seed(seed_or_key)
+    elif np.size(seed_or_key) == 2:  # jax random key
+      np.random.seed(seed_or_key[0])
+    else:
+      raise ValueError(f"seed_or_key should be an integer or a tuple of two integers.")
+    DEFAULT.seed(seed_or_key)
     yield
   finally:
     np.random.set_state(old_np_state)
@@ -1223,7 +1235,8 @@ def seed_context(seed: int):
 
 
 def rand(*dn, key: Optional[SeedOrKey] = None, dtype: DTypeLike = None):
-  r"""Random values in a given shape.
+  r"""
+  Random values in a given shape.
 
   .. note::
       This is a convenience function for users porting code from Matlab,
@@ -4796,10 +4809,9 @@ def _size2shape(size):
 
 
 def _check_shape(name, shape, *param_shapes):
-  shape = core.as_named_shape(shape)
   if param_shapes:
-    shape_ = lax.broadcast_shapes(shape.positional, *param_shapes)
-    if shape.positional != shape_:
+    shape_ = lax.broadcast_shapes(shape, *param_shapes)
+    if shape != shape_:
       msg = ("{} parameter shapes must be broadcast-compatible with shape "
              "argument, and the result of broadcasting the shapes must equal "
              "the shape argument, but got result {} for shape argument {}.")

brainstate/transform/_control.py

@@ -25,7 +25,7 @@ import jax.numpy as jnp
 import numpy as np
 
 from brainstate._utils import set_module_as
-from ._jit_error import jit_error
+from ._jit_error import jit_error, remove_vmap
 from ._make_jaxpr import StatefulFunction, _assign_state_values
 from ._progress_bar import ProgressBar
 
@@ -347,7 +347,7 @@ def _wrap_fun_with_pbar(fun, pbar_runner):
   def new_fun(new_carry, inputs):
     i, old_carry = new_carry
     old_carry, old_outputs = fun(old_carry, inputs)
-    pbar_runner(i)
+    pbar_runner(remove_vmap(i, op='none'))
     return (i + 1, old_carry), old_outputs
 
   return new_fun

brainstate/transform/_jit_error_test.py

@@ -16,8 +16,8 @@
 import unittest
 
 import jax
-import jaxlib.xla_extension
 import jax.numpy as jnp
+import jaxlib.xla_extension
 
 import brainstate as bst
 

brainstate/transform/_make_jaxpr.py

@@ -71,8 +71,8 @@ from jax.util import wraps
 
 from brainstate._state import State, StateTrace
 from brainstate._utils import set_module_as
+from brainstate.typing import PyTree
 
-PyTree = Any
 AxisName = Hashable
 
 __all__ = [

brainstate/typing.py

@@ -14,13 +14,16 @@
 # ==============================================================================
 
 
-from typing import Any, Sequence, Protocol, Union
+import functools as ft
+import typing
+from typing import Sequence, Protocol, Union, Any, Generic, TypeVar
 
 import brainunit as bu
 import jax
 import numpy as np
 
 __all__ = [
+  'PyTree',
   'Size',
   'Axes',
   'SeedOrKey',
@@ -29,6 +32,151 @@ __all__ = [
   'DTypeLike',
 ]
 
+_T = TypeVar("_T")
+
+
+class _FakePyTree(Generic[_T]):
+  pass
+
+
+_FakePyTree.__name__ = "PyTree"
+_FakePyTree.__qualname__ = "PyTree"
+_FakePyTree.__module__ = "builtins"
+
+
+class _MetaPyTree(type):
+  def __call__(self, *args, **kwargs):
+    raise RuntimeError("PyTree cannot be instantiated")
+
+  # Can't return a generic (e.g. _FakePyTree[item]) because generic aliases don't do
+  # the custom __instancecheck__ that we want.
+  # We can't add that __instancecheck__  via subclassing, e.g.
+  # type("PyTree", (Generic[_T],), {}), because dynamic subclassing of typeforms
+  # isn't allowed.
+  # Likewise we can't do types.new_class("PyTree", (Generic[_T],), {}) because that
+  # has __module__ "types", e.g. we get types.PyTree[int].
+  @ft.lru_cache(maxsize=None)
+  def __getitem__(cls, item):
+    if isinstance(item, tuple):
+      if len(item) == 2:
+
+        class X(PyTree):
+          leaftype = item[0]
+          structure = item[1].strip()
+
+        if not isinstance(X.structure, str):
+          raise ValueError(
+            "The structure annotation `struct` in "
+            "`brainstate.typing.PyTree[leaftype, struct]` must be be a string, "
+            f"e.g. `brainstate.typing.PyTree[leaftype, 'T']`. Got '{X.structure}'."
+          )
+        pieces = X.structure.split()
+        if len(pieces) == 0:
+          raise ValueError(
+            "The string `struct` in `brainstate.typing.PyTree[leaftype, struct]` "
+            "cannot be the empty string."
+          )
+        for piece_index, piece in enumerate(pieces):
+          if (piece_index == 0) or (piece_index == len(pieces) - 1):
+            if piece == "...":
+              continue
+          if not piece.isidentifier():
+            raise ValueError(
+              "The string `struct` in "
+              "`brainstate.typing.PyTree[leaftype, struct]` must be be a "
+              "whitespace-separated sequence of identifiers, e.g. "
+              "`brainstate.typing.PyTree[leaftype, 'T']` or "
+              "`brainstate.typing.PyTree[leaftype, 'foo bar']`.\n"
+              "(Here, 'identifier' is used in the same sense as in "
+              "regular Python, i.e. a valid variable name.)\n"
+              f"Got piece '{piece}' in overall structure '{X.structure}'."
+            )
+        name = str(_FakePyTree[item[0]])[:-1] + ', "' + item[1].strip() + '"]'
+      else:
+        raise ValueError(
+          "The subscript `foo` in `brainstate.typing.PyTree[foo]` must either be a "
+          "leaf type, e.g. `PyTree[int]`, or a 2-tuple of leaf and "
+          "structure, e.g. `PyTree[int, 'T']`. Received a tuple of length "
+          f"{len(item)}."
+        )
+    else:
+      name = str(_FakePyTree[item])
+
+      class X(PyTree):
+        leaftype = item
+        structure = None
+
+    X.__name__ = name
+    X.__qualname__ = name
+    if getattr(typing, "GENERATING_DOCUMENTATION", False):
+      X.__module__ = "builtins"
+    else:
+      X.__module__ = "brainstate.typing"
+    return X
+
+
+# Can't do `class PyTree(Generic[_T]): ...` because we need to override the
+# instancecheck for PyTree[foo], but subclassing
+# `type(Generic[int])`, i.e. `typing._GenericAlias` is disallowed.
+PyTree = _MetaPyTree("PyTree", (), {})
+if getattr(typing, "GENERATING_DOCUMENTATION", False):
+  PyTree.__module__ = "builtins"
+else:
+  PyTree.__module__ = "brainstate.typing"
+PyTree.__doc__ = """Represents a PyTree.
+
+Annotations of the following sorts are supported:
+```python
+a: PyTree
+b: PyTree[LeafType]
+c: PyTree[LeafType, "T"]
+d: PyTree[LeafType, "S T"]
+e: PyTree[LeafType, "... T"]
+f: PyTree[LeafType, "T ..."]
+```
+
+These correspond to:
+
+a. A plain `PyTree` can be used an annotation, in which case `PyTree` is simply a
+    suggestively-named alternative to `Any`.
+    ([By definition all types are PyTrees.](https://jax.readthedocs.io/en/latest/pytrees.html))
+
+b. `PyTree[LeafType]` denotes a PyTree all of whose leaves match `LeafType`. For
+    example, `PyTree[int]` or `PyTree[Union[str, Float32[Array, "b c"]]]`.
+
+c. A structure name can also be passed. In this case
+    `jax.tree_util.tree_structure(...)` will be called, and bound to the structure name.
+    This can be used to mark that multiple PyTrees all have the same structure:
+    ```python
+    def f(x: PyTree[int, "T"], y: PyTree[int, "T"]):
+        ...
+    ```
+
+d. A composite structure can be declared. In this case the variable must have a PyTree
+    structure each to the composition of multiple previously-bound PyTree structures.
+    For example:
+    ```python
+    def f(x: PyTree[int, "T"], y: PyTree[int, "S"], z: PyTree[int, "S T"]):
+        ...
+
+    x = (1, 2)
+    y = {"key": 3}
+    z = {"key": (4, 5)}  # structure is the composition of the structures of `y` and `z`
+    f(x, y, z)
+    ```
+    When performing runtime type-checking, all the individual pieces must have already
+    been bound to structures, otherwise the composite structure check will throw an error.
+
+e. A structure can begin with a `...`, to denote that the lower levels of the PyTree
+    must match the declared structure, but the upper levels can be arbitrary. As in the
+    previous case, all named pieces must already have been seen and their structures
+    bound.
+
+f. A structure can end with a `...`, to denote that the PyTree must be a prefix of the
+    declared structure, but the lower levels can be arbitrary. As in the previous two
+    cases, all named pieces must already have been seen and their structures bound.
+"""  # noqa: E501
+
 Size = Union[int, Sequence[int]]
 Axes = Union[int, Sequence[int]]
 SeedOrKey = Union[int, jax.Array, np.ndarray]
@@ -44,7 +192,7 @@ ArrayLike = Union[
   np.ndarray,  # NumPy array type
   np.bool_, np.number,  # NumPy scalar types
   bool, int, float, complex,  # Python scalar types
-  bu.Quantity,  # quantity
+  bu.Quantity,  # Quantity
 ]
 
 # --- Dtype --- #

{brainstate-0.0.1.1.post20240708.dist-info → brainstate-0.0.1.1.post20240804.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: brainstate
-Version: 0.0.1.1.post20240708
+Version: 0.0.1.1.post20240804
 Summary: A State-based Transformation System for Brain Dynamics Programming.
 Home-page: https://github.com/brainpy/brainstate
-Author: BrainPy Team
+Author: BDP
 Author-email: BrainPy Team <chao.brain@qq.com>
 License: Apache-2.0 license
 Project-URL: homepage, http://github.com/brainpy

{brainstate-0.0.1.1.post20240708.dist-info → brainstate-0.0.1.1.post20240804.dist-info}/RECORD

@@ -1,33 +1,33 @@
 brainstate/__init__.py,sha256=oxslZrm6wxtBQDqwJFb2BaAKZFmnp4d_esDkaeuGMWE,1410
-brainstate/_module.py,sha256=UjhfmY26VHQ-kF6U4l68AslGU6vhfD-dR7gF-4Io5ic,52520
+brainstate/_module.py,sha256=YJDp9aD38wBa_lY6BojWjWV9LJ2aFMAMYh-KZe5a4eM,52443
 brainstate/_module_test.py,sha256=oQaoaZBTo1o3wHrMEJTInQCc7RdcVs1gcfQGvdSb1SI,7843
 brainstate/_random_for_unit.py,sha256=eW4NJkX27VCCNWUwAlyt2otkeEthGKOpUoX6XJ6i95Y,1946
-brainstate/_state.py,sha256=ykQluBkdKIcQsd7-pU_UlpnByWFof_8TYQl1hGn7HS8,11629
+brainstate/_state.py,sha256=C0widCOj_ca6zfqh95jzFXf_G5vi0hJyuQ5GIqEqOUs,12102
 brainstate/_state_test.py,sha256=HDdipndRLhEHWEdTmyT1ayEBkbv6qJKykfCWKI6yJ_E,1253
 brainstate/_utils.py,sha256=RLorgGJkt2BhbX4C-ygd-PPG0wfcGCghjSP93sRvzqM,833
 brainstate/environ.py,sha256=LwRwnFaTbv8l7nHRIbSV46WzcN7pGLQFhT_xDUox2yA,10240
-brainstate/mixin.py,sha256=f0XovWlyTOQKC63WTtzSbztRSld3pKEHy9-I1gVZWLg,10748
-brainstate/mixin_test.py,sha256=qFLw9Bq8TkOMg8M8CcI92BYvFekXkjyCC9lXSEVa8Ck,2919
-brainstate/random.py,sha256=OMa4739GbrQpKspEx0TbeBqjA4yvwwJzdtpr-kJZN6s,187841
+brainstate/mixin.py,sha256=OumTTSVyYSbtudjfS_MRThsBaeVJ_0JggeMClY7xtBA,10758
+brainstate/mixin_test.py,sha256=-Ej9oUOu8O1M4oy37SVMj7xNRYhHHyAHwrjS_aISayo,2923
+brainstate/random.py,sha256=rqwSsiUoeZwxhk9ot8NnOJA8iWMdZB0HaHOVuweJdZQ,188387
 brainstate/random_test.py,sha256=cCeuYvlZkCS2_RgG0vipZFNSHG8b-uJ7SXM9SZDCYQM,17866
 brainstate/surrogate.py,sha256=1kgbn82GSlpReIytIVl29yozk75gkdZv0gTBlixQ4C4,43798
-brainstate/typing.py,sha256=tZyXpopNtp1UvqbntnmlUP6OBTM_ywyV9QBQ6Gu3IdU,2232
+brainstate/typing.py,sha256=6BlkLSN5TiaNO49q8b0OYyzcuSxmdoG3noIJTbyhE3s,7895
 brainstate/util.py,sha256=y-6eX1z3EMyg6pfZt4YdDalOnJ3HDAT1IPBCJDp-gQI,19876
 brainstate/functional/__init__.py,sha256=j6-3Er4fgqWpvntzYCZVB3e5hoz-Z3aqvapITCuDri0,1107
-brainstate/functional/_activations.py,sha256=xlwvYG8qvpkfMEZTFxD_4amW63ZfEa8x3vzVH2hDgeY,17791
+brainstate/functional/_activations.py,sha256=gvZ9E1-TsEUlyO7Om0eYzlM9DF-14_A32-gta1mjGo4,17798
 brainstate/functional/_normalization.py,sha256=IxE580waloZylZVXcpUUK4bWQdlE6oSPfafaKYfDkbg,2169
-brainstate/functional/_others.py,sha256=ifB-l82y7ZB632yLUJOEcpkRY-yOoiJ0mtDOxNilp4M,1711
+brainstate/functional/_others.py,sha256=1Epp75RkGYobMc2kHISZuS-_xnTFk3zHb1UHadwugCo,1711
 brainstate/functional/_spikes.py,sha256=70qGvo4B--QtxfJMjLwGmk9pVsf2x2YNEEgjT-il_Jw,2574
 brainstate/init/__init__.py,sha256=R1dHgub47o-WJM9QkFLc7x_Q7GsyaKKDtrRHTFPpC5g,1097
 brainstate/init/_base.py,sha256=jRTmfoUsH_315vW9YMZzyIn2KDAAsv56SplBnvOyBW0,1148
-brainstate/init/_generic.py,sha256=yLkmYRWpGHUK_nYx_fWPe74s_Cd-JDdQ6mUqpi4yqcc,7308
-brainstate/init/_random_inits.py,sha256=ycxH9WyKvPhRbk9PkamCLlc9aX5YokREBfSCbrbFQQ4,16021
+brainstate/init/_generic.py,sha256=LB7IQfswOG6X-q0QX5N8T5vZmxdygetsSBQ6iXlZ0oU,7324
+brainstate/init/_random_inits.py,sha256=LsfvKSX4wsR7Kh5jgKgdyXTCEEa5Nn_iYcp_2GgLQKY,16030
 brainstate/init/_regular_inits.py,sha256=u77aSM0BkK9VULFJQZ1lIEYA_sJJzEZBTEttBSJ79RI,3090
 brainstate/nn/__init__.py,sha256=YJHoI8cXKVRS8f2vUl3Zegp5wm0svMz3qo9JmQJiMQk,2162
 brainstate/nn/_base.py,sha256=lzbZpku3Q2arH6ZaAwjs6bhbV0RcFChxo2UcpnX5t84,8481
 brainstate/nn/_connections.py,sha256=GSOW2IbpJRHdPyF4nFJ2RPgO8y6SVHT1Gn-pbri9pMk,22970
 brainstate/nn/_dynamics.py,sha256=OeYYXv1dqjUDcCsRhZo1XS7SP2li1vlH9uhME_PE9v0,13205
-brainstate/nn/_elementwise.py,sha256=6BTqSvSnaHhldwB5ol5OV0hPJ5yJ-Jpm4WSrtFKMNoQ,43579
+brainstate/nn/_elementwise.py,sha256=Br2yd1kdr06iWGSvpoebWWO6suXFDiF8PQv_hOX9kZQ,43599
 brainstate/nn/_embedding.py,sha256=WbgrIaM_14abN8zBDr0xipBOsFc8dXP2m7Z_aRLAfmU,2249
 brainstate/nn/_misc.py,sha256=Xc4U4NLmvfnKdBNDayFrRBPAy3p0beS6T9C59rIDP00,3790
 brainstate/nn/_normalizations.py,sha256=9yVDORAEpqEkL9MYSPU4m7C4q8Qj5UNsPh9sKmIt5gQ,14329
@@ -50,17 +50,17 @@ brainstate/optim/_sgd_optimizer.py,sha256=JiK_AVGregL0wn8uHhRQvK9Qq7Qja7dEyLW6Aa
 brainstate/transform/__init__.py,sha256=my2X4ZW0uKZRfN82zyGEPizWNJ0fsSP2akvmkjn43ck,1458
 brainstate/transform/_autograd.py,sha256=Pj_YxpU52guaxQs1NcB6qDtXgkvaPcoJbuvIF8T-Wmk,23964
 brainstate/transform/_autograd_test.py,sha256=RWriMemIF9FVFUjQh4IHzLhT9LGyd1JXpjXfFZKHn10,38654
-brainstate/transform/_control.py,sha256=NWceTIuLlj2uGTdNcqBAXgnaLuChOGgAtIXtFn5vdLU,26837
+brainstate/transform/_control.py,sha256=0NFUGLIenqKuBhBiTmY0YgCrl2GI1ZbuWMW0DSOolpE,26874
 brainstate/transform/_controls_test.py,sha256=mPUa_qmXXVxDziAJrPWRBwsGnc3cHR9co08eJB_fJwA,7648
 brainstate/transform/_jit.py,sha256=sjQHFV8Tt75fpdl12jjPRDPT92_IZxBBJAG4gapdbNQ,11471
 brainstate/transform/_jit_error.py,sha256=8rGRx8dtvmPWmHVOsfz30EUMXSix-m2PKM3Ni_9-_7I,4829
-brainstate/transform/_jit_error_test.py,sha256=MGFSCih6GVXTmLh0K-m8RX8N4x2_CAgtcGOIWfzol88,1862
+brainstate/transform/_jit_error_test.py,sha256=GAVGL0eNJ5Fu0lHABCGc-nLfa_0x0tw_VPfURB-nhLc,1862
 brainstate/transform/_jit_test.py,sha256=5ltT7izh_OS9dcHnRymmVhq01QomjwZGdA8XzwJRLb4,2868
-brainstate/transform/_make_jaxpr.py,sha256=vMPruKfp5Ugv8RL-9wGfQdSumLZdLtThZvv3sU9MDjE,30426
+brainstate/transform/_make_jaxpr.py,sha256=ZkrOZu4_0xcILuPUA3RFEkorJ-xbDuDtXorJI_qVThE,30450
 brainstate/transform/_make_jaxpr_test.py,sha256=K3vRUBroDTCCx0lnmhgHtgrlWvWglJO2f1K2phTvU70,3819
 brainstate/transform/_progress_bar.py,sha256=VGoRZPRBmB8ELNwLc6c7S8QhUUTvn0FY46IbBm9cuYM,3502
-brainstate-0.0.1.1.post20240708.dist-info/LICENSE,sha256=VZe9u1jgUL2eCY6ZPOYgdb8KCblCHt8ECdbtJid6e1s,11550
-brainstate-0.0.1.1.post20240708.dist-info/METADATA,sha256=HN33Hoom47puNsauzxdmXvsmcP5RqrUpeR_2tVf7Y5U,3816
-brainstate-0.0.1.1.post20240708.dist-info/WHEEL,sha256=bb2Ot9scclHKMOLDEHY6B2sicWOgugjFKaJsT7vwMQo,110
-brainstate-0.0.1.1.post20240708.dist-info/top_level.txt,sha256=eQbGgKn0ptx7FDWuua0V0wr4K1VHi2iOUCYo3fUQBRA,11
-brainstate-0.0.1.1.post20240708.dist-info/RECORD,,
+brainstate-0.0.1.1.post20240804.dist-info/LICENSE,sha256=VZe9u1jgUL2eCY6ZPOYgdb8KCblCHt8ECdbtJid6e1s,11550
+brainstate-0.0.1.1.post20240804.dist-info/METADATA,sha256=RTuqQrR0-syn5SyxoyEbfbdAUpXBRxNMzpaqnVM2cqQ,3807
+brainstate-0.0.1.1.post20240804.dist-info/WHEEL,sha256=bb2Ot9scclHKMOLDEHY6B2sicWOgugjFKaJsT7vwMQo,110
+brainstate-0.0.1.1.post20240804.dist-info/top_level.txt,sha256=eQbGgKn0ptx7FDWuua0V0wr4K1VHi2iOUCYo3fUQBRA,11
+brainstate-0.0.1.1.post20240804.dist-info/RECORD,,