4surix/atomion

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

• Atomion
• Aperçu
• Installer
• Licence

Atomion

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.

atomion's Issues

Ajouter un nouvelle objet "Solution"

Explication

Actuellement dans atomion, le regroupement d’espèces le plus complexe que nous pouvons faire sont les molécules.
Cependant il existe d'autre regroupement davantage complexe comme les solutions.
Je pense qu'il serait donc intéressant de rajouter un objet Solution dans le but de simuler différent type de solution avec les différentes espèces qu'elle peut contenir.

Proposition de fonctionnement

L'objet contiendrait dans un dictionnaire les différentes espèces présentes sous la forme : {espèce: quantités}.
L'espèce sera un objet et la quantité sera un entier qui correspondra combien de fois cette espèce est présente.
Plusieurs propriétés peut être définie, par exemple pH pour savoir le pH de la solution.
Un objet SolutionAqueuse permettra de créer une solution avec comme soluté de l'eau distillé directement.

Exemple

from atomion import *

solution = Solution({
    Molecule("H-C(=O)OH"): 10*mol, # 180ml d'acide formique
    Molecule("SiO2"): 1*mol
})

aq = SolutionAqueuse(ml=1000)
solution = aq({
    Molecule("NaCl"): 2*mol # 114g de sel
})

aq = SolutionAqueuse(ml=1000)
solution = aq({
    Molecule("NH3"): 1*mol
})
solution.pH == 9.25

Egalité entre un proton et un ion hydrogène

Explication

Actuellement, si nous comparons un proton et un ion hydrogène (Proton() == Ion('{H+}')) cela renvoie False.
Cela est dû à la méthode spéciale de l'égalité __eq__ qui compare la représentation des objets, donc comme un proton et un ion ne se note pas pareil la comparaison renvoie faux.

    def __eq__(self, obj: Any) -> bool:
        return repr(self) == repr(obj)

Interrogation

Je ne sais pas si il faut laisser ou corriger cela.
Techniquement un ion hydrogène est un proton, vu que si on enlève l'électron de l'hydrogène il ne reste que le proton; cependant est ce que c'est vraiment identique ?

Solution

Soit l'égalité compare dorénavant le nombre de proton d'un objet.

    def __eq__(self, obj: Any) -> bool:
        return self.proton == obj.proton

Soit on compare seulement le nombre de proton dés qu'un proton et un ion sont comparés entre eux.

    def __eq__(self, obj: Any) -> bool:
        if isinstance(obj, Proton) and isinstance(obj, Ion):
            return self.proton == obj.proton
        else:
            return return repr(self) == repr(obj)