Skip to main content

Simalleles

PyPI Python Licence : AGPL-3.0 Tests

Présentation

SimAlleles est un outil pédagogique et scientifique pour explorer, visualiser et modéliser les mécanismes de l'évolution. Il se décline en une interface web interactive et une bibliothèque Python légère, sans dépendance pour le moteur.

  • Aligné sur les programmes : notions de Première, Terminale (spécialité SVT) et université.
  • Trois modes de service : local sur un poste, LAN pour une salle de classe, ou site public derrière un reverse proxy HTTPS/WSS.
  • Moteur réutilisable : la simulation s'importe dans un script ou un notebook, sans interface graphique.
  • Léger : pip install simalleles installe le moteur seul, l'extra [ui] ajoute NiceGUI.

Démo publique : https://simalleles.asurix.fr.

Paramètres

Paramètre Défaut Plage Effet
Nombre de générations 10 ≥ 1 Nombre de transitions simulées ; la sortie contient n + 1 générations (0 à n).
Nombre de populations 1 ≥ 1 Populations indépendantes, nommées P1, P2, etc.
Individus par population 1000 ≥ 1 Effectif initial de chaque population.
Taux de reproduction 1.00 > 0 Nombre d'enfants visés par individu et par génération. 1 maintient l'effectif, > 1 le fait croître, < 1 le réduit.
Inceste (%) 0 0–100 Probabilité de chercher le second parent dans la famille (parents, fratrie).
Migration (%) 0 0–100 Probabilité qu'un individu change de population. Sans effet avec une seule population.
Mutation (%) 0 0–100 Probabilité qu'un individu mute d'un seul allèle (A ↔ a).
Poids allèle A 1.00 > 0 Poids de transmission de A lors du tirage des gamètes.
Poids allèle a 1.00 > 0 Poids de transmission de a lors du tirage des gamètes.
Croisements A/A, A/a, a/a cochés booléens Influencent la construction de la génération initiale.
Couleurs du graphique activé booléen Traits colorés ou blancs avec des marqueurs distincts.
Axe Y 0–100 activé booléen Fixe l'axe vertical entre 0 et 100 %.

Les pourcentages sont des probabilités par individu et par génération. La mutation n'affecte qu'un seul des deux allèles. La graine (seed) n'est pas exposée dans l'interface ; elle est disponible dans l'API moteur pour rendre une démonstration reproductible.

Installation

pip install simalleles          # moteur seul (aucune dépendance)
pip install "simalleles[ui]"    # avec l'interface web NiceGUI

Prérequis : Python 3.10 ou plus récent.

Démarrage rapide

Le moteur peut être utilisé sans serveur ni navigateur :

from simalleles import Simulation, SimulationConfig

config = SimulationConfig(
    nbr_generations=30,
    nbr_populations=2,
    nbr_individus=100,
    taux=1.0,
    inceste=0,
    migration=10,
    mutation=1,
    weight_A=1.0,
    weight_a=1.0,
    seed=42,              # optionnel : rend la simulation reproductible
)

result = Simulation(config).run()

for name, history in result.items():
    last = history[-1]
    print(name, last["generation"], last["pourcentages"])

result est un dictionnaire population -> liste de générations. Chaque génération contient generation, les comptes a_a, A_A, a_A, A_a et le tuple pourcentages au format (a/a, A/A, hétérozygotes). La génération 0 est la génération initiale ; nbr_generations=30 produit donc 31 lignes.

La graine rend une exécution reproductible en pratique, mais aucune garantie bit-à-bit n'est fournie entre versions ou environnements. Les résultats restent stochastiques : une différence entre deux exécutions n'est pas nécessairement imputable à un paramètre.

Lancement

simalleles                      # script installé : serveur sur 127.0.0.1:8080 + navigateur
python -m simalleles            # équivalent
python -m simalleles.web        # équivalent

Options utiles :

Option Effet
--host Adresse d'écoute (défaut 127.0.0.1, forcée à 0.0.0.0 en LAN/site).
--port Port d'écoute (défaut 8080).
--no-show Ne pas ouvrir automatiquement le navigateur.
--reload Rechargement automatique au changement de code (développement uniquement).
--lan Mode LAN : 0.0.0.0, navigateur ouvert, URL du réseau local affichées.
--site Mode site : 0.0.0.0, navigateur et rechargement désactivés, secret obligatoire.
--forwarded-allow-ips IP du reverse proxy autorisée à fournir X-Forwarded-* (défaut 127.0.0.1).

--lan et --site sont mutuellement exclusifs.

simalleles --host 127.0.0.1 --port 8080
simalleles --no-show
simalleles --reload

Depuis le code source

pip install -e ".[ui]"
python -m simalleles.web

Tests

pip install -e ".[ui,dev]"
python -m pytest tests/ -v

Les 22 tests couvrent le moteur, les modes local/LAN/site, la CLI, l'export CSV et l'isolation de deux clients. Les tests d'interface utilisent nicegui.testing.user_plugin (headless, sans navigateur).

Code source et licence

Le code est disponible sur https://github.com/4surix/simalleles et distribué sous GNU AGPL-3.0.

Metadata

Release files for simalleles 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simalleles 0.9.0
File Size Uploaded Provenance Actions
simalleles-0.9.0.tar.gz 39.6 kB With provenance Details for simalleles-0.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for simalleles 0.9.0
File Interpreter ABI Platform Actions
simalleles-0.9.0-py3-none-any.whl Python 3 none any Details for simalleles-0.9.0-py3-none-any.whl

Total release size: 77.5 kB

Release files / simalleles-0.9.0.tar.gz

Download URL simalleles-0.9.0.tar.gz
Size 39.6 kB
Tags Source
SHA-256 checksum
How to use checksums
96d196049e55552f4b019890ac051eb7a914ea20bb45e01c6ab38b5c060a7d28
BLAKE2b-256 checksum
How to use checksums
5b2564bd22e6be90f0130126d8e242216225d83a84de6472be621ea4571fa904
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / simalleles-0.9.0-py3-none-any.whl

Download URL simalleles-0.9.0-py3-none-any.whl
Size 37.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1b89bbb471e268378134221356a668426fb293ab5f78671dbec7df163defce42
BLAKE2b-256 checksum
How to use checksums
9911f207c98355fed6b70044eeeab325e86ddab2c4b2e100df5a594ce647cbc9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for simalleles 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for simalleles-0.9.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.9.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page