imt-ring 1.6.42__py3-none-any.whl → 1.6.46__py3-none-any.whl

{imt_ring-1.6.42.dist-info → imt_ring-1.6.46.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: imt-ring
-Version: 1.6.42
+Version: 1.6.46
 Summary: RING: Recurrent Inertial Graph-based Estimator
 Author-email: Simon Bachhuber <simon.bachhuber@fau.de>
 Project-URL: Homepage, https://github.com/SimiPixel/ring
@@ -32,12 +32,15 @@ Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: nbmake; extra == "dev"
 
 <p align="center">
-<img src="https://raw.githubusercontent.com/simon-bachhuber/ring/main/docs/img/icon.svg" height="200" />
+<img src="https://raw.githubusercontent.com/simon-bachhuber/ring/main/docs/img/concept_v4.png" height="200" />
 </p>
 
+
 # Recurrent Inertial Graph-based Estimator (RING)
 <img src="https://raw.githubusercontent.com/simon-bachhuber/ring/main/docs/img/coverage_badge.svg" height="20" />
 
+RING provides a pluripotent, problem-unspecific plug-and-play IMT solution that, in contrast to conventional IMT solutions, eliminates the need for expert knowledge to identify, select, and parameterize the appropriate method. RING's pluripotency is enabled by a novel online-capable neural network architecture that uses a decentralized network of message-passing, parameter-sharing recurrent neural networks, which map local IMU measurements and nearest-neighbour messages to local orientations. This architecture enables RING to address a broad range of IMT problems that vary greatly in aspects such as the number of attached sensors, or the number of segments in the kinematic chain, and even generalize to previously unsolved IMT problems, including the challenging combination of magnetometer-free and sparse sensing with unknown sensor-to-segment parameters. Remarkably, RING is trained solely on simulated data, yet evaluated on experimental data, which indicates its exceptional ability to zero-shot generalize from simulation to experiment, while outperforming several state-of-the-art problem-specific solutions. For example, RING can, for the first time, accurately track a four-segment kinematic chain (which requires estimating four orientations) using only two magnetometer-free inertial measurement units.
+
 > **ℹ️ Tip:**
 > 
 > Check out my new plug-and-play interface for inertial motion tracking (RING included) [here](https://github.com/simon-bachhuber/imt.git).
@@ -50,26 +53,23 @@ Install with `pip` using
 
 `pip install imt-ring`
 
-Typically, this will install `jax` as cpu-only version. Afterwards, gpu-enabled version can be installed with
-```bash
-pip install --upgrade "jax[cuda12_pip]" -f https://storage.googleapis.com/jax-releases/jax_cuda_releases.html
-```
+Typically, this will install `jax` as cpu-only version. For GPU install instructions for `jax` see https://github.com/jax-ml/jax?tab=readme-ov-file#instructions.
 
 ## Documentation
 
-Available [here](https://simipixel.github.io/ring/).
+Available [here](https://simon-bachhuber.github.io/ring/).
 
 ## Quickstart Example
 ```python
 import ring
 import numpy as np
 
-T  : int       = 30        # sequence length     [s]
-Ts : float     = 0.01      # sampling interval   [s]
-B  : int       = 1         # batch size
-lam: list[int] = [0, 1, 2] # parent array
-N  : int       = len(lam)  # number of bodies
-T_i: int       = int(T/Ts) # number of timesteps
+T  : int       = 30         # sequence length     [s]
+Ts : float     = 0.01       # sampling interval   [s]
+B  : int       = 1          # batch size
+lam: list[int] = [-1, 0, 1] # parent array
+N  : int       = len(lam)   # number of bodies
+T_i: int       = int(T/Ts)  # number of timesteps
 
 X              = np.zeros((B, T_i, N, 9))
 # where X is structured as follows:
@@ -112,7 +112,11 @@ Solution:
 
 ## Publications
 
-The following publications utilize this software library, and refer to it as the *Random Chain Motion Generator (RCMG)* (more specifically the function `ring.RCMG`):
+The main publication is:
+
+- [*Recurrent Inertial Graph-Based Estimator (RING): A Single Pluripotent Inertial Motion Tracking Solution*](https://openreview.net/pdf?id=h2C3rkn0zR)
+
+The following publications also utilize this software library, and refer to it as the *Random Chain Motion Generator (RCMG)* (more specifically the function `ring.RCMG`):
 
 - [*RNN-based Observability Analysis for Magnetometer-Free Sparse Inertial Motion Tracking*](https://ieeexplore.ieee.org/document/9841375)
 - [*Plug-and-Play Sparse Inertial Motion Tracking With Sim-to-Real Transfer*](https://ieeexplore.ieee.org/document/10225275)
@@ -126,3 +130,8 @@ Particularly useful is the following publication from *Roy Featherstone*
 ## Contact
 
 Simon Bachhuber (simon.bachhuber@fau.de)
+
+### How to bump verion in this python package
+
+1) commit and *push* your code changes. Make sure to also update the version in `pyproject.toml`
+2) create the tag and push the tag

{imt_ring-1.6.42.dist-info → imt_ring-1.6.46.dist-info}/RECORD

@@ -15,7 +15,7 @@ ring/algorithms/custom_joints/rr_joint.py,sha256=jnRtjtOCALMaq2_0bcu2d7qgfQ6etXp
 ring/algorithms/custom_joints/rsaddle_joint.py,sha256=QoMo6NXdYgA9JygSzBvr0eCdd3qKhUgCrGPNO2Qdxko,1200
 ring/algorithms/custom_joints/suntay.py,sha256=TZG307NqdMiXnNY63xEx8AkAjbQBQ4eO6DQ7R4j4D08,16726
 ring/algorithms/generator/__init__.py,sha256=bF-CW3x2x-o6KWESKy-DuxzZPh3UNSjJb_MaAcSHGsQ,277
-ring/algorithms/generator/base.py,sha256=klWYt6TlMluLu0ihGzmmPXBm47DOTpjXJylZVNXHVEk,22419
+ring/algorithms/generator/base.py,sha256=yPH_RIQPU_nlq58HyZ6T3RUm1S5chA3-Ro__-ArYTq0,22669
 ring/algorithms/generator/batch.py,sha256=xp1X8oYtwI6l2cH4GRu9zw-P8dnh-X1FWTSyixEfgr8,2652
 ring/algorithms/generator/finalize_fns.py,sha256=ty1NaU-Mghx1RL-voivDjS0TWSKNtjTmbdmBnShhn7k,10398
 ring/algorithms/generator/motion_artifacts.py,sha256=2VJbldVDbI3PSyboshIbtYvSAKzBBwGV7cQfYjqvluM,9167
@@ -86,7 +86,8 @@ ring/utils/randomize_sys.py,sha256=G_vBIo0OwQkXL2u0djwbaoaeb02C4LQCTNNloOYIU2M,3
 ring/utils/utils.py,sha256=gKwOXLxWraeZfX6EbBcg3hkq30DcXN0mcRUeOSTNiMo,7336
 ring/utils/register_gym_envs/__init__.py,sha256=PtPIRBQJ16339xZ9G9VpvqrvcGbQ_Pk_SUz4tQPa9nQ,94
 ring/utils/register_gym_envs/saddle.py,sha256=tA5CyW_akSXyDm0xJ83CtOrUMVElH0f9vZtEDDJQalI,4422
-imt_ring-1.6.42.dist-info/METADATA,sha256=xpcG74pMBIr3v0CQkG9zNZ0BCefDZAVhrOPu31Pb4Uk,4251
-imt_ring-1.6.42.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-imt_ring-1.6.42.dist-info/top_level.txt,sha256=EiT790-lAyi8iwTzJArH3f2k77rwhDn00q-4PlmvDQo,5
-imt_ring-1.6.42.dist-info/RECORD,,
+imt_ring-1.6.46.dist-info/METADATA,sha256=9NOkzI2PpdcJpw90_ZV0smHEWyhkrZyEF211Wy1gNpg,5888
+imt_ring-1.6.46.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+imt_ring-1.6.46.dist-info/entry_points.txt,sha256=npNqSOvNiBR0BNa_GL3J66q8Gky3h0G_PHzHzk8oyE0,66
+imt_ring-1.6.46.dist-info/top_level.txt,sha256=EiT790-lAyi8iwTzJArH3f2k77rwhDn00q-4PlmvDQo,5
+imt_ring-1.6.46.dist-info/RECORD,,

{imt_ring-1.6.42.dist-info → imt_ring-1.6.46.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (75.8.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

imt_ring-1.6.46.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ring-view = ring.extras.interactive_viewer:main

ring/algorithms/generator/base.py

@@ -1,5 +1,6 @@
 from dataclasses import replace
 from functools import partial
+import logging
 import random
 from typing import Callable, Optional
 import warnings
@@ -20,6 +21,8 @@ from ring.algorithms.generator import motion_artifacts
 from ring.algorithms.generator import setup_fns
 from ring.algorithms.generator import types
 
+logger = logging.getLogger(__name__)
+
 
 class RCMG:
     def __init__(
@@ -237,7 +240,9 @@ class RCMG:
     def _generators_ncalls(self, sizes: int | list[int] = 1):
         "Returns list of unbatched sequences as numpy arrays."
         repeats = self._compute_repeats(sizes)
+        logger.info(f"`repeats` = {repeats}")
         sizes = list(jnp.array(repeats) * jnp.array(self._size_of_generators))
+        logger.info(f"`sizes` = {sizes}")
 
         reduced_repeats = []
         n_calls = []
@@ -246,6 +251,9 @@ class RCMG:
             gcd = utils.gcd(n_call, repeat)
             n_calls.append(gcd)
             reduced_repeats.append(repeat // gcd)
+        logger.info(f"`reduced_repeats` = {reduced_repeats}")
+        logger.info(f"`n_calls` = {n_calls}")
+
         jits = [N > 1 for N in n_calls]
 
         gens = []