===== Quiette ===== 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 [[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 CLASSPATH=$QUIETTE_HOME/siette-quimica-3.7.jar java -classpath $CLASSPATH siette.quimica.Quiette "$@" 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 ==== Una vez instalado el comando ''quiette'' hay varios modos de funcionamiento: * Generar un compuesto al azar. * Identificar un compuesto por su nombre. * 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 > quiette -r PdO: Monóxido de monopaladio; Óxido de paladio(II) > quiette -r 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 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 Rb2O2: Dióxido de dirubidio; Peróxido de rubidio > quiette -r -oxido -peroxido Pr2O3: Trióxido de dipraseodimio; Óxido de praseodimio > quiette -r -oxido -peroxido 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, por ejemplo el parámetro ''-n.s'' hace que se muestre solamente la nomenclatura sistemática.: > quiette -r -oxido -peroxido -n.s Rb2O2: Dióxido de dirubidio > quiette -r -oxido -peroxido -n.s Pr2O3: Trióxido de dipraseodimio > quiette -r -oxido -peroxido -n.s 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 -3 -en CaO: Calcium oxide > quiette -r -oxido -peroxido -n.s -3 -en PbO4: Monolead tetraoxide > quiette -r -oxido -peroxido -n.s -3 -en NiO: Mononickel monoxide === Identificar un compuesto por su nombre === 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 HNO3: Hidrogeno(trioxidonitrato); Hidróxidodioxidonitrógeno; Ácido nítrico > quiette "Óxido de fósforo(I)" P2O: Monóxido de difósforo; Óxido de fósforo(I) > quiette "Monóxido de monopaladio" 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 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 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