Diferencias

Muestra las diferencias entre dos versiones de la página.

--- es:manual:quimica:siette.quimica.quiette [2025/05/05 09:41] – root
+++ es:manual:quimica:siette.quimica.quiette [2025/06/12 10:04] (actual) – root
@@ Línea 1: / Línea 1: @@
 ===== Quiette =====
-Quiette es una aplicación de consola que funciona de forma independiente a Siette y que utiliza la funcionalidad implementada en el paquete ''siette.quimica''.
+Esta es una clase principal que implementa una aplicación de consola que funciona de forma independiente a Siette y que utiliza la funcionalidad del paquete ''siette.quimica''.
 ==== Instalacion ====
-La aplicación Quiette requiere previamente la instalación de Java. Para instalar la instrucción ''quiette'' es necesario descargar el paquete ''siette-quimica-3.7.jar'' e incluirlo de alguna forma en el ''CLASSPATH'' al realizar la llamada a ''java''. Por mayor comodidad se puede instalar un commando ''quiette'' con el siguiente contenido:
+La aplicación Quiette requiere previamente la instalación de Java. Para instalar la instrucción ''quiette'' es necesario descargar el paquete [[https://github.com/rconejo/siette-quimica/blob/26f9ec0354f280c997a86b0ad1a79df48e6ea98d/target/siette-quimica-3.7.jar|siette-quimica-3.7.jar]] e incluirlo de alguna forma en el ''CLASSPATH'' al realizar la llamada a ''java''.
+Es decir, copiar el fichero ''siette-quimica-3.7.jar'' en un directorio al que llamaremos $QUIETTE_HOME, y para mayor comodidad crear un commando ''quiette'' en el mismo directorio con el siguiente contenido:
    #!/bin/bash
-   LIB=$QUIETTE_HOME/lib
+   CLASSPATH=$QUIETTE_HOME/siette-quimica-3.7.jar
-   CLASSPATH=$LIB/siette-quimica-3.7.jar
    java -classpath $CLASSPATH siette.quimica.Quiette "$@"
-e incluir la ubicación de este comando en la variable ''PATH'' del sistema.
+Una vez hecho esto, incluir la ubicación de este comando en la variable ''PATH'' del sistema, ya sea de forma temporarl o permanente agregando esta instrucción al fichero ''.bashrc'' o a cualquier otro que se ejecute al iniciar sesión.
+   export PATH=$PATH:$QUIETTE_HOME
 ==== Uso de quiette ====
@@ Línea 20: / Línea 23: @@
   * Generar un compuesto al azar.
   * Identificar un compuesto por su nombre.
-  * Identificar un compuesto por su formula.
+  * Identificar un compuesto por su fórmula.
 === Generar un compuesto al azar ===
-Para generar un compuesto al azar basta con llamar a quiette con la opción ''-r'', por ejemplo
+Para generar un compuesto al azar basta con llamar a ''quiette'' con la opción ''-r'', por ejemplo
     > quiette -r
     PdO: Monóxido de monopaladio; Óxido de paladio(II)
     > quiette -r
-    Lr4(F2O3)3: Tris(Trioxidodifluorato) de tetralawrencio; Trioxidodiflúor(4-) de Lawrencio(3+)
+    H4I2SO4: Tetrahidrogeno(tetraoxidosulfurodiyodato); Tetrahidróxidosulfurodiyodo; Ácido tiodiyodoso
     > quiette -r
     Cr(HTe)3: Tris(hidrogenotelururo) de monocromo; Hidrogenotelururo de cromo(III)
-Puede restringir el tipo de compuesto a generar usando algunos parametros en la entrada, (véase la lista completa de argumentos) por ejemplo, para generar solamente óxidos o peróxidos
+Puede restringir el tipo de compuesto a generar usando algunos parámetros en la entrada, (véase la lista completa de argumentos) por ejemplo, para generar solamente óxidos o peróxidos
     > quiette -r -oxido -peroxido
@@ Línea 42: / Línea 45: @@
     P2O: Monóxido de difósforo; Óxido de fósforo(I)
-También se puede restringir la nomenclatura a utilizar (véase la lista completa de argumentos), utilizando argumentos:
+También se puede restringir la nomenclatura a utilizar (véase la lista completa de argumentos), utilizando argumentos, por ejemplo el parámetro ''-n.s'' hace que se muestre solamente la nomenclatura sistemática.:
     > quiette -r -oxido -peroxido -n.s
@@ Línea 51: / Línea 54: @@
     P2O: Monóxido de difósforo
+Si no se indica ninguna notación se usan solo las notaciones habituales de cada tipo de compuesto que estén admitidas por la IUPAC.
+Es posible restringir la lista de elementos de la tabla periódica a un subconjunto de elementos mas comunes que son los que se incluyen en los planes de estudios de la ESO, para ello basta indicar el parámetro ''-3'' o ''-4''
+    > quiette -r -oxido -peroxido -n.s -3
+    Sb2O2: Dióxido de diantimonio
+    > quiette -r -oxido -peroxido -n.s -3
+    H2O2: Dióxido de dihidrógeno
+    > quiette -r -oxido -peroxido -n.s -3
+    BeO: Óxido de berilio
 Finalmente, también es posible generar los nombre en ingles, añadiendo el parámetro ''-en''
-    > quiette -r -oxido -peroxido -n.s -en
+    > quiette -r -oxido -peroxido -n.s -3 -en
-    Rb2O2: Dióxido de dirubidio
+    CaO: Calcium oxide
-    > quiette -r -oxido -peroxido -n.s -en
+    > quiette -r -oxido -peroxido -n.s -3 -en
-    Pr2O3: Trióxido de dipraseodimio
+    PbO4: Monolead tetraoxide
-    > quiette -r -oxido -peroxido -n.s -en
+    > quiette -r -oxido -peroxido -n.s -3 -en
-    P2O: Monóxido de difósforo
+    NiO: Mononickel monoxide
-=== Identificar un compuesto por su. nombre ===
+=== Identificar un compuesto por su nombre ===
-Otra forma de usar ''quiette'' es simplemenmte para identificar la formula de un compuesto dado su nombre en cualquier nomenclatura,((Tenga en cuenta que si se usan paréntesis el shell no debe interpretarlos por lo que el nombre del compuesto debe ir entre comillas dobles.)) por ejemplo:
+Otra forma de usar ''quiette'' es simplemente para identificar la formula de un compuesto dado su nombre en cualquier nomenclatura,((Tenga en cuenta que si se usan paréntesis el //shell// no debe interpretarlos por lo que el nombre del compuesto debe ir entre comillas dobles.)) por ejemplo:
     > quiette Acido nitrico
@@ Línea 68: / Línea 83: @@
     > quiette "Óxido de fósforo(I)"
     P2O: Monóxido de difósforo; Óxido de fósforo(I)
-    > quiette "Tris(Trioxidodifluorato) de tetralawrencio"
+    > quiette "Monóxido de monopaladio"
-    Lr4(F2O3)3: Tris(Trioxidodifluorato) de tetralawrencio; Trioxidodiflúor(4-) de Lawrencio(3+)
+    PdO: Monóxido de monopaladio; Óxido de paladio(II)
+Al igual que en el caso anterior también pueden usarse las opciones de nomenclatura y de idioma para gestionar la salida.
+=== Identificar un compuesto por su fórmula ===
+Es un caso análogo al anterior solo que en este caso se trata de hallar el compuesto dada su fórmula.
+    > quiette H2O2
+    H2O2: Dióxido de dihidrógeno; Peróxido de hidrógeno; Agua oxigenada
+    > quiette H2SO4
+    H2SO4: Dihidrogeno(tetraoxidosulfato); Dihidróxidodioxidoazufre; Ácido sulfúrico
+    > quiette Na2CO3
+    Na2CO3: Trioxidocarbonato de disodio; Trioxidocarbono(2-) de Sodio(1+)
+Al igual que en el caso anterior también pueden usarse las opciones de nomenclatura y de idioma. Además puede usarse la opcin´n ''-a'' para que el sistema muestre compuestos alternativos con pequeñas variaciones de la fórmula propuesta, por ejemplo:
+    > quiette SO4H2 -a
+    No se ha encontrado ningún compuesto
+    ¿Quiso decir? :
+    H2SO4: Dihidrogeno(tetraoxidosulfato); Dihidróxidodioxidoazufre; Ácido sulfúrico
+==== Argumentos ====
+Para obtener la lista completa de argumentos de llamada a ''quiette'' basta escribir el comando sin ningún argumento:
+    > quiette
+    quiette [formula|nombre] [OPCIONES] [TIPO DE COMPUESTO] [NOMENCLATURAS] [NIVEL]
+    OPTIONS
+       -ayuda | ?              Mostrar esta ayuda
+       -p <properties fichero> Leer opciones desde un fichero de propiedades
+       -r                      Generar un compuesto al azar
+       -es                     Español (por defecto)
+       -en                     Ingles
+       -a                      Mostrar alternativas a una formula incorrecta
+    TIPO DE COMPUESTO (elegir cualquier mnumero)
+       -elemento               Generar un elementoi quimico
+       -oxido                  Generar un oxido
+       -peroxido               Generar un proxido
+       -hidruro                Generar un hidruro
+       -haluro                 Generar un haluro
+       -salbinaria             Generar una sal binaria
+       -salacida               Generar una sal binaria acida
+       -hidroxido              Generar un hidroxido
+       -oxoacido               Generaar un oxoacido
+       -oxosal                 Genberar una oxosal
+       -tioacido               Generar un tioacido
+       -cyanide                Generar un compuesto con ion cianuro
+       -sal                    Si se ha declarado previamente -oxoacido, gerera también una oxosal, si no genera una sal binaria
+       -poliatomic(o|a)        Generar un oxoacido politomico y/o una sal poliatomica si las opciones -oxoacido y/o -oxosal han sido declaradas previamente
+    NOMENCLATURAS (elegir cualquier mnumero)
+       -n.s                   Mostrar nomenclatura sistematica
+       -n.st | n.o            Mostrar nomenclatura de Stock, con mumeros romanos
+       -n.h                   Mostrar nomenclatura de hidrogeno
+       -n.a                   Mostrar nomenclatura de adicion
+       -n.t                   Mostrar nomenclatura tradicional (en caso de que este actualmente aceptada por IUPAC)
+       -n.c                   Mostrar nomenclatura clasica (aunque no este aceptada ya por IUPAC)
+    NIVEL (elegir uno)
+       -3                     Usar solo elementos incluidos en la lista de 3ro ESO (3ESO)
+       -4                     Usar solo elementos incluidos en la lista de 3to ESO (4ESO)
+Igualmente existe una ayuda en ingles ((Nótese que los argumentos también pueden indicarse en inglés)):
+    > quiette -help
+    quiette [formula|name] [OPTIONS] [COMPOUND TYPES] [NOMENCLATURES] [LEVEL]
+    OPTIONS
+       -help                  Show this help
+       -p <properties file>   Read options from properties file
+       -r                     Randomly generate a chemical compund
+       -es                    Spanish (default)
+       -en                    English
+       -a                     Show alternatives for a given wrong formula
+    COMPOUND TYPES (choose any)
+       -element               Randomly generate a single element
+       -oxide                 Randomly generate an oxide
+       -peroxide              Randomly generate a peroxide
+       -hydride               Randomly generate an hydride
+       -halide                Randomly generate an halide
+       -binarysalt            Randomly generate a binary salt
+       -acidsalt              Randomly generate an acid salt
+       -hydroxide             Randomly generate an hydroxide
+       -oxoacid               Randomly generate an oxoacid
+       -oxoacidsalt           Randomly generate an oxoacidsalt
+       -thioacid              Randomly generate a thioacid
+       -cyanide               Randomly generate a cyanide
+       -salt                  Randomly generate an oxoacidsalt if -oxoacid is declared, otherwise generate a binary salt
+       -poliatomic            Randomly generate an poliatomic oxoacid and/or a politomic oxosalt if -oxoacid and/or -oxosalt has been previously declared
+    NOMENCLATURES (choose any)
+       -n.s                   Show systematic nomenclature
+       -n.st | n.o            Show Stock nomenclature, with roman oxidation numbers
+       -n.h                   Show hdrogen nomenclature
+       -n.a                   Show addition nomenclature
+       -n.t                   Show traditional nomenclature (currently accepted by IUPAC)
+       -n.c                   Show classical nomenclature (currently not accepted by IUPAC)
+    LEVEL (choose one)
+       -3                     Use only elements marked for level 3 (3ESO)
+       -4                     Use only elements marked for level 4 (4ESO)
+==== Ficheros de propiedades ====
+Para facilitar el uso de ''quiette'' se pueden definir ficheros de configuración que predefinen parámetros de entrada. El fichero de configuración por defecto se llama ''.quiette.properties'' y estará situado en el directorio raíz del usuario. En segundo lugar ''quiette'' intenta cargar un fichero de propriedades de nombre ''.quiette.properties'' situado en el directorio de trabajo, o el fichero que se le haya indicado en la llamada con el argumento ''-p''. Los argumentos de la llamada sobrescriben los parámetros previamente definidos en los ficheros de propiedades.
+Los siguientes identificadores son validos en los ficheros de propiedades, tanto en español como en inglés:
+   quiette.idioma=es                 quiette.lang=es
+   quiette.idioma=en                 quiette.lang=es
+   quiette.aleatorio=true            quiette.random=true
+   quiette.alternativas=true         quiette.alternatives=true
+   quiette.elemento=true             quiette.element=true
+   quiette.oxido=true                quiette.oxide=true
+   quiette.peroxido=true             quiette.peroxide=true
+   quiette.hidruro=true              quiette.hydride=true
+   quiette.haluro=true               quiette.halide=true
+   quiette.salbinaria=true           quiette.binarysalt=true
+   quiette.salacida=true             quiette.acidsalt=true
+   quiette.oxoacido=true             quiette.oxoacid=true
+   quiette.oxosal=true               quiette.oxosalt=true
+   quiette.oxoacidopoliatomico=true  quiette.poliatomicoxoacid=true
+   quiette.oxosalpoliatomica=true    quiette.poliatomicoxosalt=true
+   quiette.tioacido=true             quiette.thioacid=true
+   quiette.ciano=true                quiette.cyanide=true
+   quiette.sistematica=true          quiette.sistematic=true
+   quiette.stock=true                quiette.stock=true
+   quiette.hidrogeno=true            quiette.hydrogen=true
+   quiette.adicion=true              quiette.addition=true
+   quiette.tradicional=true          quiette.traditional=true
+   quiette.clasica=true              quiette.classic=true
+   quiette.nivel=3eso                quiette.level=3
+   quiette.nivel=4eso                quiette.level=4
+Por ejemplo, si el fichero ''~/.quiette.properties'' contiene la linea ''siette.lang=en'' la opción por defecto será analizar los nombres y presentar los resultados en inglés, sin necesidad de uar continuamente la opción ''-en'' en la llamada.
+   > quiette -r
+   PuO3: Monoplutonium trioxide; Plutonium(VI) oxide
+   > quiette H2O
+   H2O: Dihydrogen oxide; Hydrogen oxide; Water