brainstate 0.0.2.post20241009__py2.py3-none-any.whl → 0.1.0__py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. brainstate/__init__.py +31 -11
  2. brainstate/_state.py +760 -316
  3. brainstate/_state_test.py +41 -12
  4. brainstate/_utils.py +31 -4
  5. brainstate/augment/__init__.py +40 -0
  6. brainstate/augment/_autograd.py +608 -0
  7. brainstate/augment/_autograd_test.py +1193 -0
  8. brainstate/augment/_eval_shape.py +102 -0
  9. brainstate/augment/_eval_shape_test.py +40 -0
  10. brainstate/augment/_mapping.py +525 -0
  11. brainstate/augment/_mapping_test.py +210 -0
  12. brainstate/augment/_random.py +99 -0
  13. brainstate/{transform → compile}/__init__.py +25 -13
  14. brainstate/compile/_ad_checkpoint.py +204 -0
  15. brainstate/compile/_ad_checkpoint_test.py +51 -0
  16. brainstate/compile/_conditions.py +259 -0
  17. brainstate/compile/_conditions_test.py +221 -0
  18. brainstate/compile/_error_if.py +94 -0
  19. brainstate/compile/_error_if_test.py +54 -0
  20. brainstate/compile/_jit.py +314 -0
  21. brainstate/compile/_jit_test.py +143 -0
  22. brainstate/compile/_loop_collect_return.py +516 -0
  23. brainstate/compile/_loop_collect_return_test.py +59 -0
  24. brainstate/compile/_loop_no_collection.py +185 -0
  25. brainstate/compile/_loop_no_collection_test.py +51 -0
  26. brainstate/compile/_make_jaxpr.py +756 -0
  27. brainstate/compile/_make_jaxpr_test.py +134 -0
  28. brainstate/compile/_progress_bar.py +111 -0
  29. brainstate/compile/_unvmap.py +159 -0
  30. brainstate/compile/_util.py +147 -0
  31. brainstate/environ.py +408 -381
  32. brainstate/environ_test.py +34 -32
  33. brainstate/{nn/event → event}/__init__.py +6 -6
  34. brainstate/event/_csr.py +308 -0
  35. brainstate/event/_csr_test.py +118 -0
  36. brainstate/event/_fixed_probability.py +271 -0
  37. brainstate/event/_fixed_probability_test.py +128 -0
  38. brainstate/event/_linear.py +219 -0
  39. brainstate/event/_linear_test.py +112 -0
  40. brainstate/{nn/event → event}/_misc.py +7 -7
  41. brainstate/functional/_activations.py +521 -511
  42. brainstate/functional/_activations_test.py +300 -300
  43. brainstate/functional/_normalization.py +43 -43
  44. brainstate/functional/_others.py +15 -15
  45. brainstate/functional/_spikes.py +49 -49
  46. brainstate/graph/__init__.py +33 -0
  47. brainstate/graph/_graph_context.py +443 -0
  48. brainstate/graph/_graph_context_test.py +65 -0
  49. brainstate/graph/_graph_convert.py +246 -0
  50. brainstate/graph/_graph_node.py +300 -0
  51. brainstate/graph/_graph_node_test.py +75 -0
  52. brainstate/graph/_graph_operation.py +1746 -0
  53. brainstate/graph/_graph_operation_test.py +724 -0
  54. brainstate/init/_base.py +28 -10
  55. brainstate/init/_generic.py +175 -172
  56. brainstate/init/_random_inits.py +470 -415
  57. brainstate/init/_random_inits_test.py +150 -0
  58. brainstate/init/_regular_inits.py +66 -69
  59. brainstate/init/_regular_inits_test.py +51 -0
  60. brainstate/mixin.py +236 -244
  61. brainstate/mixin_test.py +44 -46
  62. brainstate/nn/__init__.py +26 -51
  63. brainstate/nn/_collective_ops.py +199 -0
  64. brainstate/nn/_dyn_impl/__init__.py +46 -0
  65. brainstate/nn/_dyn_impl/_dynamics_neuron.py +290 -0
  66. brainstate/nn/_dyn_impl/_dynamics_neuron_test.py +162 -0
  67. brainstate/nn/_dyn_impl/_dynamics_synapse.py +320 -0
  68. brainstate/nn/_dyn_impl/_dynamics_synapse_test.py +132 -0
  69. brainstate/nn/_dyn_impl/_inputs.py +154 -0
  70. brainstate/nn/{_projection/__init__.py → _dyn_impl/_projection_alignpost.py} +6 -13
  71. brainstate/nn/_dyn_impl/_rate_rnns.py +400 -0
  72. brainstate/nn/_dyn_impl/_rate_rnns_test.py +64 -0
  73. brainstate/nn/_dyn_impl/_readout.py +128 -0
  74. brainstate/nn/_dyn_impl/_readout_test.py +54 -0
  75. brainstate/nn/_dynamics/__init__.py +37 -0
  76. brainstate/nn/_dynamics/_dynamics_base.py +631 -0
  77. brainstate/nn/_dynamics/_dynamics_base_test.py +79 -0
  78. brainstate/nn/_dynamics/_projection_base.py +346 -0
  79. brainstate/nn/_dynamics/_state_delay.py +453 -0
  80. brainstate/nn/_dynamics/_synouts.py +161 -0
  81. brainstate/nn/_dynamics/_synouts_test.py +58 -0
  82. brainstate/nn/_elementwise/__init__.py +22 -0
  83. brainstate/nn/_elementwise/_dropout.py +418 -0
  84. brainstate/nn/_elementwise/_dropout_test.py +100 -0
  85. brainstate/nn/_elementwise/_elementwise.py +1122 -0
  86. brainstate/nn/_elementwise/_elementwise_test.py +171 -0
  87. brainstate/nn/_exp_euler.py +97 -0
  88. brainstate/nn/_exp_euler_test.py +36 -0
  89. brainstate/nn/_interaction/__init__.py +32 -0
  90. brainstate/nn/_interaction/_connections.py +726 -0
  91. brainstate/nn/_interaction/_connections_test.py +254 -0
  92. brainstate/nn/_interaction/_embedding.py +59 -0
  93. brainstate/nn/_interaction/_normalizations.py +388 -0
  94. brainstate/nn/_interaction/_normalizations_test.py +75 -0
  95. brainstate/nn/_interaction/_poolings.py +1179 -0
  96. brainstate/nn/_interaction/_poolings_test.py +219 -0
  97. brainstate/nn/_module.py +328 -0
  98. brainstate/nn/_module_test.py +211 -0
  99. brainstate/nn/metrics.py +309 -309
  100. brainstate/optim/__init__.py +14 -2
  101. brainstate/optim/_base.py +66 -0
  102. brainstate/optim/_lr_scheduler.py +363 -400
  103. brainstate/optim/_lr_scheduler_test.py +25 -24
  104. brainstate/optim/_optax_optimizer.py +103 -176
  105. brainstate/optim/_optax_optimizer_test.py +41 -1
  106. brainstate/optim/_sgd_optimizer.py +950 -1025
  107. brainstate/random/_rand_funs.py +3269 -3268
  108. brainstate/random/_rand_funs_test.py +568 -0
  109. brainstate/random/_rand_seed.py +149 -117
  110. brainstate/random/_rand_seed_test.py +50 -0
  111. brainstate/random/_rand_state.py +1360 -1318
  112. brainstate/random/_random_for_unit.py +13 -13
  113. brainstate/surrogate.py +1262 -1243
  114. brainstate/{nn/_projection/_utils.py → transform.py} +1 -2
  115. brainstate/typing.py +157 -130
  116. brainstate/util/__init__.py +52 -0
  117. brainstate/util/_caller.py +100 -0
  118. brainstate/util/_dict.py +734 -0
  119. brainstate/util/_dict_test.py +160 -0
  120. brainstate/util/_error.py +28 -0
  121. brainstate/util/_filter.py +178 -0
  122. brainstate/util/_others.py +497 -0
  123. brainstate/util/_pretty_repr.py +208 -0
  124. brainstate/util/_scaling.py +260 -0
  125. brainstate/util/_struct.py +524 -0
  126. brainstate/util/_tracers.py +75 -0
  127. brainstate/{_visualization.py → util/_visualization.py} +16 -16
  128. {brainstate-0.0.2.post20241009.dist-info → brainstate-0.1.0.dist-info}/METADATA +11 -11
  129. brainstate-0.1.0.dist-info/RECORD +135 -0
  130. brainstate/_module.py +0 -1637
  131. brainstate/_module_test.py +0 -207
  132. brainstate/nn/_base.py +0 -251
  133. brainstate/nn/_connections.py +0 -686
  134. brainstate/nn/_dynamics.py +0 -426
  135. brainstate/nn/_elementwise.py +0 -1438
  136. brainstate/nn/_embedding.py +0 -66
  137. brainstate/nn/_misc.py +0 -133
  138. brainstate/nn/_normalizations.py +0 -389
  139. brainstate/nn/_others.py +0 -101
  140. brainstate/nn/_poolings.py +0 -1229
  141. brainstate/nn/_poolings_test.py +0 -231
  142. brainstate/nn/_projection/_align_post.py +0 -546
  143. brainstate/nn/_projection/_align_pre.py +0 -599
  144. brainstate/nn/_projection/_delta.py +0 -241
  145. brainstate/nn/_projection/_vanilla.py +0 -101
  146. brainstate/nn/_rate_rnns.py +0 -410
  147. brainstate/nn/_readout.py +0 -136
  148. brainstate/nn/_synouts.py +0 -166
  149. brainstate/nn/event/csr.py +0 -312
  150. brainstate/nn/event/csr_test.py +0 -118
  151. brainstate/nn/event/fixed_probability.py +0 -276
  152. brainstate/nn/event/fixed_probability_test.py +0 -127
  153. brainstate/nn/event/linear.py +0 -220
  154. brainstate/nn/event/linear_test.py +0 -111
  155. brainstate/random/random_test.py +0 -593
  156. brainstate/transform/_autograd.py +0 -585
  157. brainstate/transform/_autograd_test.py +0 -1181
  158. brainstate/transform/_conditions.py +0 -334
  159. brainstate/transform/_conditions_test.py +0 -220
  160. brainstate/transform/_error_if.py +0 -94
  161. brainstate/transform/_error_if_test.py +0 -55
  162. brainstate/transform/_jit.py +0 -265
  163. brainstate/transform/_jit_test.py +0 -118
  164. brainstate/transform/_loop_collect_return.py +0 -502
  165. brainstate/transform/_loop_no_collection.py +0 -170
  166. brainstate/transform/_make_jaxpr.py +0 -739
  167. brainstate/transform/_make_jaxpr_test.py +0 -131
  168. brainstate/transform/_mapping.py +0 -109
  169. brainstate/transform/_progress_bar.py +0 -111
  170. brainstate/transform/_unvmap.py +0 -143
  171. brainstate/util.py +0 -746
  172. brainstate-0.0.2.post20241009.dist-info/RECORD +0 -87
  173. {brainstate-0.0.2.post20241009.dist-info → brainstate-0.1.0.dist-info}/LICENSE +0 -0
  174. {brainstate-0.0.2.post20241009.dist-info → brainstate-0.1.0.dist-info}/WHEEL +0 -0
  175. {brainstate-0.0.2.post20241009.dist-info → brainstate-0.1.0.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,211 @@
1
+ # Copyright 2024 BDP Ecosystem Limited. All Rights Reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+ # ==============================================================================
15
+
16
+ from __future__ import annotations
17
+
18
+ import unittest
19
+
20
+ import jax.numpy as jnp
21
+ import jaxlib.xla_extension
22
+
23
+ import brainstate as bst
24
+
25
+
26
+ class TestDelay(unittest.TestCase):
27
+ def test_delay1(self):
28
+ a = bst.State(bst.random.random(10, 20))
29
+ delay = bst.nn.Delay(a.value)
30
+ delay.register_entry('a', 1.)
31
+ delay.register_entry('b', 2.)
32
+ delay.register_entry('c', None)
33
+
34
+ delay.init_state()
35
+ with self.assertRaises(KeyError):
36
+ delay.register_entry('c', 10.)
37
+
38
+ def test_rotation_delay(self):
39
+ rotation_delay = bst.nn.Delay(jnp.ones((1,)))
40
+ t0 = 0.
41
+ t1, n1 = 1., 10
42
+ t2, n2 = 2., 20
43
+
44
+ rotation_delay.register_entry('a', t0)
45
+ rotation_delay.register_entry('b', t1)
46
+ rotation_delay.register_entry('c2', 1.9)
47
+ rotation_delay.register_entry('c', t2)
48
+
49
+ rotation_delay.init_state()
50
+
51
+ print()
52
+ # print(rotation_delay)
53
+ # print(rotation_delay.max_length)
54
+
55
+ for i in range(100):
56
+ bst.environ.set(i=i)
57
+ rotation_delay.update(jnp.ones((1,)) * i)
58
+ # print(i, rotation_delay.at('a'), rotation_delay.at('b'), rotation_delay.at('c2'), rotation_delay.at('c'))
59
+ self.assertTrue(jnp.allclose(rotation_delay.at('a'), jnp.ones((1,)) * i))
60
+ self.assertTrue(jnp.allclose(rotation_delay.at('b'), jnp.maximum(jnp.ones((1,)) * i - n1, 0.)))
61
+ self.assertTrue(jnp.allclose(rotation_delay.at('c'), jnp.maximum(jnp.ones((1,)) * i - n2, 0.)))
62
+
63
+ def test_concat_delay(self):
64
+ rotation_delay = bst.nn.Delay(jnp.ones([1]), delay_method='concat')
65
+ t0 = 0.
66
+ t1, n1 = 1., 10
67
+ t2, n2 = 2., 20
68
+
69
+ rotation_delay.register_entry('a', t0)
70
+ rotation_delay.register_entry('b', t1)
71
+ rotation_delay.register_entry('c', t2)
72
+
73
+ rotation_delay.init_state()
74
+
75
+ print()
76
+ for i in range(100):
77
+ bst.environ.set(i=i)
78
+ rotation_delay.update(jnp.ones((1,)) * i)
79
+ print(i, rotation_delay.at('a'), rotation_delay.at('b'), rotation_delay.at('c'))
80
+ self.assertTrue(jnp.allclose(rotation_delay.at('a'), jnp.ones((1,)) * i))
81
+ self.assertTrue(jnp.allclose(rotation_delay.at('b'), jnp.maximum(jnp.ones((1,)) * i - n1, 0.)))
82
+ self.assertTrue(jnp.allclose(rotation_delay.at('c'), jnp.maximum(jnp.ones((1,)) * i - n2, 0.)))
83
+ # bst.util.clear_buffer_memory()
84
+
85
+ def test_jit_erro(self):
86
+ rotation_delay = bst.nn.Delay(jnp.ones([1]), time=2., delay_method='concat', interp_method='round')
87
+ rotation_delay.init_state()
88
+
89
+ with bst.environ.context(i=0, t=0, jit_error_check=True):
90
+ rotation_delay.retrieve_at_time(-2.0)
91
+ with self.assertRaises(jaxlib.xla_extension.XlaRuntimeError):
92
+ rotation_delay.retrieve_at_time(-2.1)
93
+ rotation_delay.retrieve_at_time(-2.01)
94
+ with self.assertRaises(jaxlib.xla_extension.XlaRuntimeError):
95
+ rotation_delay.retrieve_at_time(-2.09)
96
+ with self.assertRaises(jaxlib.xla_extension.XlaRuntimeError):
97
+ rotation_delay.retrieve_at_time(0.1)
98
+ with self.assertRaises(jaxlib.xla_extension.XlaRuntimeError):
99
+ rotation_delay.retrieve_at_time(0.01)
100
+
101
+ def test_round_interp(self):
102
+ for shape in [(1,), (1, 1), (1, 1, 1)]:
103
+ for delay_method in ['rotation', 'concat']:
104
+ rotation_delay = bst.nn.Delay(jnp.ones(shape), time=2., delay_method=delay_method,
105
+ interp_method='round')
106
+ t0, n1 = 0.01, 0
107
+ t1, n1 = 1.04, 10
108
+ t2, n2 = 1.06, 11
109
+ rotation_delay.init_state()
110
+
111
+ @bst.compile.jit
112
+ def retrieve(td, i):
113
+ with bst.environ.context(i=i, t=i * bst.environ.get_dt()):
114
+ return rotation_delay.retrieve_at_time(td)
115
+
116
+ print()
117
+ for i in range(100):
118
+ t = i * bst.environ.get_dt()
119
+ with bst.environ.context(i=i, t=t):
120
+ rotation_delay.update(jnp.ones(shape) * i)
121
+ print(i,
122
+ retrieve(t - t0, i),
123
+ retrieve(t - t1, i),
124
+ retrieve(t - t2, i))
125
+ self.assertTrue(jnp.allclose(retrieve(t - t0, i), jnp.ones(shape) * i))
126
+ self.assertTrue(jnp.allclose(retrieve(t - t1, i), jnp.maximum(jnp.ones(shape) * i - n1, 0.)))
127
+ self.assertTrue(jnp.allclose(retrieve(t - t2, i), jnp.maximum(jnp.ones(shape) * i - n2, 0.)))
128
+
129
+ def test_linear_interp(self):
130
+ for shape in [(1,), (1, 1), (1, 1, 1)]:
131
+ for delay_method in ['rotation', 'concat']:
132
+ print(shape, delay_method)
133
+
134
+ rotation_delay = bst.nn.Delay(jnp.ones(shape), time=2., delay_method=delay_method,
135
+ interp_method='linear_interp')
136
+ t0, n0 = 0.01, 0.1
137
+ t1, n1 = 1.04, 10.4
138
+ t2, n2 = 1.06, 10.6
139
+ rotation_delay.init_state()
140
+
141
+ @bst.compile.jit
142
+ def retrieve(td, i):
143
+ with bst.environ.context(i=i, t=i * bst.environ.get_dt()):
144
+ return rotation_delay.retrieve_at_time(td)
145
+
146
+ print()
147
+ for i in range(100):
148
+ t = i * bst.environ.get_dt()
149
+ with bst.environ.context(i=i, t=t):
150
+ rotation_delay.update(jnp.ones(shape) * i)
151
+ print(i,
152
+ retrieve(t - t0, i),
153
+ retrieve(t - t1, i),
154
+ retrieve(t - t2, i))
155
+ self.assertTrue(jnp.allclose(retrieve(t - t0, i), jnp.maximum(jnp.ones(shape) * i - n0, 0.)))
156
+ self.assertTrue(jnp.allclose(retrieve(t - t1, i), jnp.maximum(jnp.ones(shape) * i - n1, 0.)))
157
+ self.assertTrue(jnp.allclose(retrieve(t - t2, i), jnp.maximum(jnp.ones(shape) * i - n2, 0.)))
158
+
159
+ def test_rotation_and_concat_delay(self):
160
+ rotation_delay = bst.nn.Delay(jnp.ones((1,)))
161
+ concat_delay = bst.nn.Delay(jnp.ones([1]), delay_method='concat')
162
+ t0 = 0.
163
+ t1, n1 = 1., 10
164
+ t2, n2 = 2., 20
165
+
166
+ rotation_delay.register_entry('a', t0)
167
+ rotation_delay.register_entry('b', t1)
168
+ rotation_delay.register_entry('c', t2)
169
+ concat_delay.register_entry('a', t0)
170
+ concat_delay.register_entry('b', t1)
171
+ concat_delay.register_entry('c', t2)
172
+
173
+ rotation_delay.init_state()
174
+ concat_delay.init_state()
175
+
176
+ print()
177
+ for i in range(100):
178
+ bst.environ.set(i=i)
179
+ new = jnp.ones((1,)) * i
180
+ rotation_delay.update(new)
181
+ concat_delay.update(new)
182
+ self.assertTrue(jnp.allclose(rotation_delay.at('a'), concat_delay.at('a'), ))
183
+ self.assertTrue(jnp.allclose(rotation_delay.at('b'), concat_delay.at('b'), ))
184
+ self.assertTrue(jnp.allclose(rotation_delay.at('c'), concat_delay.at('c'), ))
185
+
186
+
187
+ class TestModule(unittest.TestCase):
188
+ def test_states(self):
189
+ class A(bst.nn.Module):
190
+ def __init__(self):
191
+ super().__init__()
192
+ self.a = bst.State(bst.random.random(10, 20))
193
+ self.b = bst.State(bst.random.random(10, 20))
194
+
195
+ class B(bst.nn.Module):
196
+ def __init__(self):
197
+ super().__init__()
198
+ self.a = A()
199
+ self.b = bst.State(bst.random.random(10, 20))
200
+
201
+ b = B()
202
+ print()
203
+ print(b.states())
204
+ print(b.states())
205
+ print(b.states(level=0))
206
+ print(b.states(level=0))
207
+
208
+
209
+ if __name__ == '__main__':
210
+ with bst.environ.context(dt=0.1):
211
+ unittest.main()