Skip to content
/ atomion Public

Manipuler des concepts physiques/chimiques (atomes, ions, équations, ...) facilement.

Notifications You must be signed in to change notification settings

4surix/atomion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Atomion

Build Status PyPI GitHub issues Download Version python Version micropython Code size Code size file

Module servant à manipuler facilement :

  • Quark
  • Proton, Neutron, Electron
  • Noyau
  • Atome
  • Ion (monoatomique/polyatomique)
  • Molécule
  • Equation chimique
  • Réaction chimique
  • Demi-équation
  • Oxydo-réduction
  • Électronégativité
  • Molécule organique
  • Reaction acido-basique
Prévues :
  • Fusion nucléaire (Non-fini)
  • Fission nucléaire
  • Gluons
  • Antimatière
  • Maintien des liaisons

Vous trouverez un dossier exemples avec les diverses fonctionnalités.

Le module est compatible avec Micro Python 1.9.4, donc aussi pour les calculatrices !

Aperçu

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 = Equation('H2 + O2 -> H2O')
equation.equilibrer()
equation == '2 H₂ + O₂ -> 2 H₂O'

equation = DemiEquation('Cl2', '{Cl -}')
equation.equilibrer()
equation == 'Cl₂ + 2 e⁻ -> 2 Cl⁻'


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₂'

Pour voir le reste des fonctionnalités, regardez le dossier exemples.

Installer

Ordinateur

  • Ouvrez une invite de commande.

    Comment faire ?

    Sur Windows, appuyez sur la touche Windows + la touche R, et écrivez cmd dans la fenêtre qui s'est ouverte.

  • Assurez-vous d'avoir Python >=3.6 d'installé.

    Comment savoir ?

    Ecrivez python --version dans l'invite de commande. Si Python est installé cela affichera la version qui doit être supérieur à 3.6. Si ce n'est pas le cas, installer Python dans une version égal ou supérieur à 3.6 pour éviter les soucis de compatibilité.

  • Vérifiez que pip est installé.

    Comment vérifier ?

    Ecrivez pip --version dans l'invite de commande. Si pip est installé cela affichera la version qui doit être supérieur à 20.0.0.
    Si ce n'est pas le cas, écrivez python -m pip install --upgrade pip pour mettre à jour.

  • Ecrivez la commande suivante :

    pip install atomion
  • Lors de nouvelle mise à jour il suffira de rajouter --upgrade pour mettre le module à jour :

    pip install atomion --upgrade
  • Ensuite créez un nouveau fichier, importez le module, et amusez vous !

    from atomion import *
    
    print(Atome('C') + Molecule('O2'))

Calculatrice

  • Téléchargez le code.
  • Ouvrez le .zip et glissez le dossier qui se trouve à l'intérieur autre part (dans un endroit accessible).
  • Ouvrez le dossier que vous avez déplacé et executer le fichier mk_file_calculatrice.py.
  • Un fichier atomion.py va se créer, mettez le dans votre calculatrice (que vous aurez branchée à votre ordi via câble USB ou autre).
  • Si vous n'avez plus rien d'autre à faire, débranchez votre calculatrice et amusez-vous !

Si le fichier est trop grand, installer python_minifier (pip install python-minifier), et recréer le fichier.

Si vous avez un problème, n'hésitez pas à regarder les issues déjà exitantes ou à en ouvrir une.

Licence

Je ne sais pas quelle licence mettre.
Tout ce que je veux c'est que tout le monde puisse l'utiliser gratuitement et librement que cela soit pour le privé, dans leur projet publique, à but éducatif ; mais je ne veux pas qu'une personne : puisse se faire de l'argent avec le projet atomion, prétend que le code du projet atomion soit le sien et pas le mien, ne cite pas le projet atomion dans leur projet.

About

Manipuler des concepts physiques/chimiques (atomes, ions, équations, ...) facilement.

Topics

Resources

Stars

Watchers

Forks

Languages