Skip to content

Species

Species class.

Species

Species in Tölvera.

Species are implemented as a State with attributes for size, speed, mass and colour (rgba), and with a length determined by the number of species in the Tölvera instance (tv.sn). The attributes are normalised and scaled by species the species_consts attribute. They are initialised with random values.

Rather than accessing this class directly, access is typically via the State attributes via the Tölvera instance, via e.g. tv.s.species.field[i].size.

Source code in src/tolvera/species.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
class Species:
    """Species in Tölvera.

    Species are implemented as a State with attributes for `size`, `speed`, `mass` and
    `colour` (rgba), and with a length determined by the number of species in the
    Tölvera instance (`tv.sn`). The attributes are normalised and scaled by species the 
    `species_consts` attribute. They are initialised with random values.

    Rather than accessing this class directly, access is typically via the State
    attributes via the Tölvera instance, via e.g. `tv.s.species.field[i].size`.
    """
    def __init__(self, tolvera, **kwargs) -> None:
        """Initialise Species

        Args:
            tolvera (Tolvera): Tolvera instance.
            **kwargs: Keyword arguments. 
        """
        self.tv = tolvera
        self.kwargs = kwargs
        self.n = self.tv.sn
        self.tv.species_consts = CONSTS(
            {
                "MIN_SIZE": (ti.f32, 2.0),
                "MAX_SIZE": (ti.f32, 5.0),
                "MIN_SPEED": (ti.f32, 0.2),
                "MAX_SPEED": (ti.f32, 2.0),
                "MAX_MASS": (ti.f32, 1.0),
            }
        )
        self.tv.s.species = (
            {
                "size": (ti.f32, 0.0, 1.0),
                "speed": (ti.f32, 0.0, 1.0),
                "mass": (ti.f32, 0.0, 1.0),
                "rgba": (ti.math.vec4, 0.0, 1.0),
            },
            self.n,
            "set",
            "set",
        )

    def randomise(self):
        """Randomise species."""
        self.tv.s.species.randomise()

__init__(tolvera, **kwargs)

Initialise Species

Parameters:

Name Type Description Default
tolvera Tolvera

Tolvera instance.

 required
**kwargs

Keyword arguments.

 {}
Source code in src/tolvera/species.py 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
def __init__(self, tolvera, **kwargs) -> None:
    """Initialise Species

    Args:
        tolvera (Tolvera): Tolvera instance.
        **kwargs: Keyword arguments. 
    """
    self.tv = tolvera
    self.kwargs = kwargs
    self.n = self.tv.sn
    self.tv.species_consts = CONSTS(
        {
            "MIN_SIZE": (ti.f32, 2.0),
            "MAX_SIZE": (ti.f32, 5.0),
            "MIN_SPEED": (ti.f32, 0.2),
            "MAX_SPEED": (ti.f32, 2.0),
            "MAX_MASS": (ti.f32, 1.0),
        }
    )
    self.tv.s.species = (
        {
            "size": (ti.f32, 0.0, 1.0),
            "speed": (ti.f32, 0.0, 1.0),
            "mass": (ti.f32, 0.0, 1.0),
            "rgba": (ti.math.vec4, 0.0, 1.0),
        },
        self.n,
        "set",
        "set",
    )

randomise()

Randomise species.

Source code in src/tolvera/species.py 
50
51
52
def randomise(self):
    """Randomise species."""
    self.tv.s.species.randomise()