A.C.E.M.U.

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.
[[:ACEMU:Artículos:Artículos Técnicos:Software|Retorno a página anterior]]

====== OpenRocket ======

===== Referencias =====
  * [[http://openrocket.sourceforge.net/|Página web de OpenRocket]]
  
===== Instalación =====
La aplicación OpenRocket consiste únicamente en un archivo .jar de Java, por ejemplo: OpenRocket-1.1.3.jar
Para su ejecución se requiere del Java RTE versión 1.5 o superior.

En las opciones de configuración del programa, se puede elegir el idioma a emplear, que incluye **ESPAÑOL** por supuesto (además de otras lenguas como el francés, que se desaconseja emplear, porque no se entiende nada!!!).

==== Linux ====
  * Bajar y copiar el archivo .jar a algún directorio: por ej. /usr/local/bin o /opt/openrocket
  * Asegurarse que tenga al menos permisos de lectura y ejecución para los usuarios comunes
  * Si se quiere ejecutar desde la consola, asegurarse que la variable PATH contiene el directorio donde se instaló el programa y que el sistema reconoce los archivo .jar como ejecutable de Java
  * Asegurarse que la versión de java requerida está instalada y disponible, se puede probar ejecutar el programa, por ej,:

  java -jar /opt/openrocket/OpenRocket-1.1.3.jar

  * Para simplificar su uso desde la GUI de Linux, se puede agregar al Menú del sistema
  * También conviene que la GUI asocie los archivo .ork con la aplicación, cosa de simplificar la carga de archivos desde la GUI

=== Agregar OpenRocket al Menú en Ubuntu ===
Esta parte fundamentalmente de qué distribución de Linux y qué interface gráfica se esté empleando. Pero suele ser bastante sencillo e intuitivo. Para ilustrar el proceso, simplemente nos remitiremos a mostrar el caso de Ubuntu 10.04.

  * Lo primero es abrir el Gestor de Menúes de Ubuntu. Para eso nos colocamos encima de la barra superior, a la izquierda, donde esté el menú de Aplicaciones y con el botón derecho del ratón abrimos una ventana de selección donde elegimos la opción de editoar el menú:

{{ :acemu:articulos:articulos_tecnicos:software:openrocket_edit_menu.jpg?300 |}}

  * Eso abre la ventana del gestor de menúes, algo similar a lo que se muestra en la siguiente figura y apretamos el botón para agregar una nueva aplicación (obviemos el hecho de que la figura ya muestra que Openrocket está en el menú)

{{ :acemu:articulos:articulos_tecnicos:software:openrocket_menu_manager.jpg?500 |}}

  * Eso da lugar a una nueva ventana, como la que vemos abajo, donde rellenamos con los datos que se requieren para ejecutar OpenRocket

{{ :acemu:articulos:articulos_tecnicos:software:openrocket_menu_app.jpg?500 |}}

El proceso es muy sencillo y seguramente con esta explicación podrá incluir OpenRocket en el menú de su Linux preferido, aunque se trate de otra versión de Ubuntu u otra distribución de Linux.

===== Cómo incluir nuevos motores en formato .ENG =====
OpenRocket dispone de una biblioteca de motores, pero permite que los usuarios agreguen sus propios motores, para poderlos usar en las simulaciones de los cohetes. Para eso debemos disponer de los datos del motor en formato ENG (o RASP).

El formato ENG o RASP es el formato original del programa wRASP. La referencia de donde extraje esta información es:

  * [[http://www.thrustcurve.org/raspformat.shtml|RASP ENG File Format, del sitio Thrustcurve.org]]

Recomiendo leer ese link, pues es la principal referencia a este tipo de archivos de datos.

Los archivos de format RASP (que suelen tener terminación .ENG, de allí que también se los conozca como formato ENG), son simples archivos ASCII, que contienen información básica de la curva de empuje de un motor, así como datos de sus características fundamentales. Es un formato muy simple y son archivos muy fáciles de construir. Alcanza con disponer de algunos valore de empuje del motor para ciertos intervalos de tiempo así como el peso del motor y el peso del combustible.

==== Formato ENG ====
Los archivos ENG tienen una estructura muy simple: consisten en una cabecera y una sección de datos de empuje
=== Cabecera ===
La siguiente imagen (extraida de la referencia anterior) resume el contenido de la cabecera del archivo

{{:acemu:software:raspheader.gif|}}

  * Las primeras lineas, que comienzan con ";", se ignoran, son simples comentarios
  * La linea que importa es la primer linea sin ";", donde van los datos básicos del motor:
      - Nombre del motor
      - Diámetro externo (mm)
      - Largo (mm)
      - Delays, hasta 3, separados por guiones. Si no tiene delay pero tiene carga de eyección, poner sólo un 0. Si no tiene carga de eyección, poner simplemente una "P" (plugged).
      - Peso del combustible (kg)
      - Peso total: motor + combustible (kg)
      - Fabricante: una única palabra de pocas letras que identifique al fabricante

=== Datos de empuje ===
Al cabezal siguen, en las siguientes lineas, los datos de empuje. El formato original soporta hasta 32 datos. No sé si para OpenRocket esto es una limitación o no, es posible que acepte más de 32 lineas.

  * Cada linea de dato de empuje consiste en 2 números: el valor del tiempo (s) y el empuje (Newton). 
  * El primer valor para tiempo 0.0 y empuje 0.0 se asume, no es necesario ponerlo. 
  * El último valor debe terminar con empuje cero (esto es importante). 
  * Luego de la última linea de datos, se pueden incluir más lineas de comentarios (;) o lineas en blanco

Ejemplo:

<code>
; Motor MX001 de ACEMU (Asociación de Cohetería Experimental y Modelista del Uruguay)
; Fabricado en talleres de la Fuerza Aérea Uruguaya en base a motor Rosarigasino argentino
; Datos de empuje obtenidos en prueba de motores 
; Archivo ENG creado por Kenneth Irving. Actualizado 22/04/2012
MX001 38 240 P 0.18 0.624 ACEMU 
0.125    98.0  
0.25     225.4  
0.375    235.2  
0.5      235.2  
0.625    196.0  
0.75     147.0   
0.875    127.4  
1.0      107.8  
1.125    88.2   
1.25     49.0    
1.375    0.0
;
</code>

==== Como instalar los archivos ENG para OpenRocket ====
=== Linux ===
Copiar el archivo .ENG al directorio ''~/.openrocket/ThrustCurves/''. De esta manera, la próxima vez que se ejecute el programa, los datos del motor estarán disponibles para OpenRocket.

=== Windows ===
Copiar el archivo .ENG a alguno de estos directorios:

  C:\Documents and Settings\username\Application Data\OpenRocket\ThrustCurves\
o
  C:\Users\username\AppData\Roaming\OpenRocket\ThrustCurves\


==== Cómo registrar OpenRocket en GNOME para que se puedan abrir los archivos .ork desde el filemanager ====

Este material todavía no está completo. La idea es registrar un nuevo MIME-type y asociarlo con una aplicación.

=== Asociar un mime-type ===
Vamos a crear un unevo mime-type que llamaremos **''application/openrocket''**

Ir a ''/usr/share/mime/packages/''

  cd  /usr/share/mime/packages/

y crear un nuevo archivo ''openrocket.xml'' con el siguiente contenido:

<code>
<?xml version='1.0' encoding='utf-8'?>
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
    <mime-type type="application/openrocket">
        <magic priority="100">
            <match value="rocket.ork" type="string" offset="0:140"/>
        </magic>
        <glob pattern="*.ork"/>
    </mime-type>
</mime-info>
</code>

El ''<glob pattern="*.ork"/>'' asocia la extensión  ''.ork'' con este tipo de mime-type, que a su vez también se reconoce por el "magic string" ''rocket.ork'' que contienen esos archivos en su interior. Hay que mejorar el dato del offset que determina dentro del archivo donde buscar el string "rocket.ork", que suele estar a partir del byte 31 del archivo.

Una vez generado el nuevo mime-type, hay que ejecutar

  update-mime-database /usr/share/mime 

para actualizar la base de datos de MIME.

Para asociar el mime-type con la aplicación, hay que editar el archivo **''~/.local/share/applications/mimeapps.list''** o **''/usr/share/applications/defaults.list''** y agregar una linea como esta:

  application/openrocket=openrocket.desktop;

En la sección **''[Added Associations]''**



=== Registar una nueva applicaciónen el menú ===
Ir a ''/usr/share/applications'' o si no se desea afectar los archivos generales sino sólo los locales del usuario, en el homedir del usuario ir a ''.local/share/applications''
Allí crear el archivo ''openrocket.desktop'' con el siguiente contenido:

<code>
[Desktop Entry]
Comment=Open Source Rocket Simulation                         
Exec=/usr/bin/java -jar /opt/openrocket/OpenRocket-13.09.1.jar  %f
GenericName=Open Rocket        
Icon=openrocket-048.png
MimeType=application/openrocket;
Name=OpenRocket
StartupNotify=false
Terminal=false
Type=Application
Categories=Programming;Science;Math;Development;Physics;
</code>

De esa manera se declara en qué categorías del menú debe aparecer al aplicación ''OpenRocket'' y se especifica qué ejecutable debe lanzarse, pero más importante aún se asocia el mimeype ''application/openrocket'' que generamos en la sección pasada con la aplicación OpenRocket que es lo que nos interesa.

La entrada ''Exec'' corresponde al ejecutable del OpenRocket y eso dependerá de donde uno lo instale. El ''%f'' es para que OpenRocket tome el nombre del archivo que se desea abrir desde el filemanager.

El ''Icon'' es el nombre del ícono de Openrocket que se puede extraer del directorio de fuentes y colocarlo, por ejemplo, en ''~/.local/share/icons/hicolor/48x48/apps/'' y de esa manera la aplicación de OpenRocket aparecerá con su ícono en el menú.

''Categories'' determina en qué categorías del menú aparecerá la aplicación OpenRocket.


Todavía no he podido asociar un ícono con el mime-type ṕara que los archivo ''.ork'' aparezcan con el ícono de OpenRocket.


[[:indice|Retorno a página principal]]\\
[[:ACEMU:Artículos:Artículos Técnicos:Software|Retorno a página anterior]]