Diferencias

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

--- es:manual:quimica:siette.quimica.quiette [2025/05/05 12:19] – 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
@@ Línea 51: / Línea 54: @@
     P2O: Monóxido de difósforo
-Es posible restringir la lista de elementos de la tabla periodica 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 parametro ''-3'' o ''-4''
+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
@@ Línea 102: / Línea 107: @@
     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