Prochaine version • Installation • Contribuer • Licence
Bibliothèque Python pure permettant de manipuler des atomes, ions, molécules et réactions chimiques de manière intuitive, aussi bien sur ordinateur que sur calculatrice.
- Syntaxe naturelle : instanciez un atome, un ion ou une équation en une seule ligne (
H + Cl -> HCl), presque comme sur papier. - Légèreté : 100 % Python pur, sans dépendance lourde (
numpy,scipyoupandas). - Compatibilité : fonctionne sur ordinateur, dans le navigateur (Pyodide / JupyterLite), sur Raspberry Pi et sur calculatrice via MicroPython 1.9.4.
- Rendu scientifique riche : affichage clair en console (configuration électronique, formules avec indices/exposants) (et futur intégration Jupyter via
_repr_html_()). - Approche pédagogique : équilibrage automatique (équations, oxydo-réduction, acido-basique) et messages d'erreur explicites en français.
from atomion import *
eau = Molecule('H2O')
equation = Equation('H2 + O2 -> H2O')
equation.equilibrer()
print(equation) # 2 H₂ + O₂ -> 2 H₂OAfficher l'aperçu détaillé des fonctionnalités
from atomion import *
oxygene = Atome('O') # Avec symbole
hydrogene = Atome(1) # Avec nombre proton
chlorure = Ion('Cl')
# Ou
chlorure = IonMonoAtomique('Cl')
carbonate = Ion('CO3')
# Ou
carbonate = Ion('{CO3 2-}')
# Ou
carbonate = IonPolyAtomique('CO3')
eau = hydrogene * 2 + oxygene
# Ou
eau = Molecule('H2O')
from atomion.raccourcis import *
eau = H * 2 + O
# Ou
eau = H2O
# Quark
proton = QUp('R') + QDown('B') + QUp('V')
neutron = QUp('R') + QDown('B') + QDown('V')
# Fusion
noyauH = Noyau(Proton(1), Neutron(1))
noyauHe, *particules = noyauH << noyauH
atomeHe = noyauHe + Electron(2)
equation = DemiEquation('Cl2', '{Cl -}')
equation.equilibrer()
equation == 'Cl₂ + 2 e⁻ -> 2 Cl⁻'
equation = Equation('H2 + O2 -> H2O')
equation.equilibrer()
equation == '2 H₂ + O₂ -> 2 H₂O'
reaction = Reaction(
equation = equation,
quantites_reactifs = {H2: 1.6, O2: 1.3}
)
reaction.final() == {H2: 0, O2: 0.5, H2O: 1.6}
oxydoR = OxydoReduction(
Ion('{Cr2O7 2-}'),
Atome('Fe')
)
oxydoR.don == 'Fe -> Fe²⁺ + 2 e⁻'
oxydoR.gain == 'Cr₂O₇²⁻ + 14 H⁺ + 6 e⁻ -> 2 Cr³⁺ + 7 H₂O'
reaction = AcidoBasique('{C3H5O2 -}', '{H3O +}')
reaction.gain == 'C₃H₅O₂⁻ + H⁺ -> C₃H₆O₂'
reaction.don == 'H₃O⁺ -> H₂O + H⁺'
reaction.equation == 'H₃O⁺ + C₃H₅O₂⁻ -> H₂O + C₃H₆O₂'Vous trouverez un dossier
exemplesavec les diverses fonctionnalités.
Le rendu des notations suit l'environnement : ¹²₆C, H₂O, Cl⁻ sur ordinateur,
C, H2O, {Cl 1-} sur calculatrice. Il peut être forcé à tout moment :
from atomion import *
from atomion.utile import params
params.config(affichage = 'ascii') # notation calculatrice
params.config(affichage = 'unicode') # notation scientifique- Tableau d'avancement : génération complète (état initial, intermédiaire, final avec
$x_{\max}$ et réactif limitant) adaptée à l'affichage console et calculatrice. - Calculs de grandeurs physiques : masse molaire (
$M$ ), quantité de matière ($n$ ), concentration massique, pH (acides/bases forts et faibles, solutions tampons) et énergie nucléaire ($\Delta m \cdot c^2$ ). - Physique nucléaire :
-
Fusion (
<<) : calcul d'énergie libérée et vérification de stabilité du noyau produit. -
Fission (
>>) : implémentation complète avec lois de Soddy et bilan énergétique. -
Radioactivité (
$\alpha$ ,$\beta^+$ ,$\beta^-$ ,$\gamma$ ) : désintégrations et énergie associée.
-
Fusion (
- Mode pédagogique & pas-à-pas : paramètre
etapes=Truepour détailler l'équilibrage des équations et réactions d'oxydo-réduction, accompagné de messages d'erreur explicites en français. - Acido-basique : détection automatique du couple acide/base conjugué lorsqu'il n'est pas renseigné.
- Chimie organique : nomenclature IUPAC des molécules linéaires simples et affichage des formules semi-développées en ASCII (ex. :
CH3-CH2-CH2-OH$\rightarrow$ propan-1-ol). - Assistant interactif calculatrice : menu guidé (
atomion.menu/assistant()) pour utiliser la bibliothèque sans connaître la syntaxe par cœur.
-
Ouvrez un terminal (invite de commande).
Comment faire selon votre système ?
- Windows : appuyez sur
Windows+R, tapezcmd(oupowershell), puis validez avecEntrée. - macOS : appuyez sur
Cmd+Espacepour ouvrir Spotlight, tapezTerminal, puis validez avecEntrée. - Linux : appuyez sur
Ctrl+Alt+Tou ouvrez l'application Terminal depuis le menu de vos applications.
- Windows : appuyez sur
-
Vérifiez que Python
>= 3.9est installé.Comment vérifier ?
Exécutez
python --version(oupython3 --versionsur macOS et Linux). La version affichée doit être supérieure ou égale à3.9.
Si ce n'est pas le cas, téléchargez et installez Python (version 3.9 ou plus récente). -
Vérifiez que
pipest à jour.Comment vérifier ?
Exécutez
pip --version(oupython -m pip --version). La version affichée doit être supérieure ou égale à20.0.0.
Pour mettrepipà jour, exécutez :python -m pip install --upgrade pip
- Installez le paquet :
pip install atomion
- Pour mettre à jour le module lors d'une nouvelle version :
pip install --upgrade atomion
- Ensuite créez un nouveau fichier, importez le module, et amusez vous !
from atomion import * print(Atome('C') + Molecule('O2'))
Atomion est compatible avec MicroPython 1.9.4, utilisé sur de nombreuses calculatrices graphiques (NumWorks, TI, Casio, etc.).
- Installez les dépendances nécessaires à la génération du fichier unique :
pip install "atomion[calc]" - Générez le fichier autonome
atomion.pydans la langue souhaitée :python3 -m mk_file_calculatrice --lang fr # Ou en anglais : python3 -m mk_file_calculatrice --lang en - Branchez votre calculatrice à votre ordinateur et copiez-y le fichier
atomion.pygénéré. - Débranchez votre calculatrice en toute sécurité, importez
atomionet amusez-vous !
Besoin d'aide ? Si vous rencontrez un problème, consultez les issues existantes ou ouvrez-en une nouvelle.
# Cloner
git clone https://github.com/4surix/atomion.git
cd atomion
# Installer en mode dev
pip install -e ".[dev]"
# Lancer les tests
python -m unittest discover -s tests
# Lint
ruff check .Ce projet est distribué sous GNU Affero General Public License v3.0 ou ultérieure (AGPL-3.0-or-later).
- Texte complet :
LICENSE- gnu.org - Vous pouvez utiliser, étudier, modifier et redistribuer atomion, y compris à des fins commerciales.
- En contrepartie : tout dérivé distribué ou exposé via un réseau (site web, API, SaaS) doit rester sous AGPL et fournir son code source à ses utilisateurs.
- La mention de copyright et la licence doivent être conservées (pas de réappropriation).
Copyright (C) 2026 Asurix.