Introducción a BioMA. Tutorial Creación de componentes

Transcripción

1 Introducción a BioMA Tutorial Creación de componentes

2 Versión Número Fecha 2 Junio de 2014 Copyright Unión Europea, Reproducción autorizada, con indicación de la fuente bibliográfica, salvo que se indique lo contrario. En los supuestos en que deba obtenerse autorización previa para la reproducción o el uso de información de texto o multimedios (sonido, imágenes, programas informáticos, etc.), esta autorización sustituirá a la anterior autorización general y deberá indicar claramente las posibles restricciones de uso. Exención de responsabilidad En cualquiera de las páginas de MARS puede encontrar referencias a un determinado paquete de software, un contratista en particular, o grupo de contratistas, el uso de uno u otro producto, como software, sensores, etc. En todos los casos, a menos que se indique específicamente, esto no indica ninguna preferencia de la Comisión Europea por ese producto, tercero o terceros en particular. Cuando sea pertinente, se incluyen enlaces a las páginas que le dan más información acerca de las referencias. No dude en ponerse en contacto con nosotros en caso de que necesite más información. 2 Tutorial: Creación de componentes

3 Índice 1 Acerca de este tutorial... 3 Recursos web de interés... 3 Qué va a aprender... 4 Contenido del paquete del tutorial Pasos del tutorial...7 Paso 1 Preparación del entorno... 8 Descarga y descompresión del paquete del tutorial... 8 Comprobación de los valores del sistema... 8 Descarga e instalación de SharpDevelop... 9 Instalación de Domain Class Coder (DCC)... 9 Instalación de Strategy Class Coder (SCC) Instalación de Models Parameter Editor (MPE) Paso 2 Creación del proyecto en SharpDevelop Creación de un proyecto Creación de una interfaz vacía Definición de un método para la lógica de la estrategia Paso 3 Creación de clases de dominio en DCC Paso 4 Compilación del proyecto en SharpDevelop Agregar archivos al proyecto Agregar al proyecto referencias a DLL Compilar el proyecto Paso 5 Creación de estrategias en SCC Paso 6 Compilación de los proyectos en SharpDevelop Agregar el archivo SCC al proyecto Agregar las referencias a DLL Compilar los dos proyectos Paso 7 Introducción del código del modelo en SharpDevelop Paso 8 Creación de la clase parámetros para la estrategia Crear la clase parámetros con DCC Agregar la clase parámetros al proyecto Paso 9 Creación del archivo de parámetros para la estrategia Cuáles son los próximos pasos? Tutorial: Creación de componentes 3

4 ÍNDICE 2 Tutorial: Creación de componentes

5 Acerca de este tutorial 1 Este documento está dirigido a los usuarios avanzados del software BioMA Framework que deseen crear sus propias soluciones de modelado. Para obtener información científica sobre los modelos utilizados, consulte la documentación de los componentes específicos. Los temas están organizados de la siguiente forma: «Qué va a aprender», página 4 «Pasos del tutorial», página 7 Recursos web de interés Recurso Guía del usuario de BioMA Framework Contenido Ayuda completa en Internet que contiene la descripción de BioMA Framework, así como un resumen de los principales componentes. Portal de BioMA Framework Portal de BioMA, que contiene vínculos a toda la documentación de los componentes disponible. Documentación de Composition Layer (capa de composición) Documento dirigido a los usuarios avanzados que desean profundizar en la codificación de la capa de composición de BioMA Framework. Tutorial: Creación de componentes 3

6 1 ACERCA DE ESTE TUTORIAL Qué va a aprender Este tutorial contiene instrucciones detalladas para crear un componente nuevo. En este caso, el componente nuevo que hemos elegido como ejemplo simula el crecimiento de patógenos fúngicos en el suelo. Utilizaremos las herramientas de BioMA para crear código interactivo, así como otros tipos de software gratuitos. Contenido del paquete del tutorial En el paquete TrainingCreateComponent.zip proporcionado para completar este tutorial encontrará: Instalador/Carpeta Qué es CodeOfMethodEstimated _tobecopiedinthestrateg y.txt Archivo de texto que contiene el código de la estrategia que se va a implementar. Es el código que vamos a utilizar en el procedimiento del paso 7, «Introducción del código del modelo» en la página 32. Bibliotecas DCC Esta carpeta contiene los archivos auxiliares (DLL) utilizados en el proceso de construcción del nuevo componente: CRA.Core.Preconditions EC.JRC.MARS.MetadataTypes EC.JRC.MARS.ModelLayer.Core EC.JRC.MARS.ModelLayer.Data EC.JRC.MARS.ModelLayer.Strategy EC.JRC.MARS.ModelLayer.StrategyConverted EC.JRC.MARS.ModelLayer.StrategyReflection.Explorer EC.JRC.MARS.ModelLayer.VarInfoConverter EC.JRC.MARS.ParametersManagement JRC.IPSC.MARS.Cache nunit.framework Instalador de la aplicación DCC (Domain Class Coder) utilizada para crear clases de dominio. 4 Tutorial: Creación de componentes

7 QUÉ VA A APRENDER Instalador/Carpeta MPE SCC Qué es Instalador de la aplicación MPE (Model Parameters Editor) utilizada para ver o editar parámetros de modelos. Esta herramienta se utilizará más tarde, cuando se cree la solución de modelado. Instalador de la aplicación SCC (Strategy Class Coder) utilizada para crear estrategias. Tutorial: Creación de componentes 5

8 1 ACERCA DE ESTE TUTORIAL 6 Tutorial: Creación de componentes

9 Pasos del tutorial 2 Este tutorial está dirigido a quienes crean modelos. Contiene los pasos necesarios para crear desde el principio un componente que contiene una estrategia. Al final del tutorial, tendrá un componente llamado MY.EXAMPLE.SoilBorne que contendrá una estrategia llamada RGRYanHunt. Los pasos son los siguientes: Paso 1: «Preparación del entorno», página 8 Paso 2: «Creación del proyecto en SharpDevelop», página 11 Paso 3: «Creación de clases de dominio en DCC», página 17 Paso 4: «Compilación del proyecto en SharpDevelop», página 21 Paso 5: «Creación de estrategias en SCC», página 25 Paso 6: «Compilación de los proyectos en SharpDevelop», página 29 Paso 7: «Introducción del código del modelo en SharpDevelop», página 32 Paso 8: «Creación de la clase parámetros para la estrategia», página 33 Paso 9: «Creación del archivo de parámetros para la estrategia», página 36 Tutorial: Creación de componentes 7

10 2 PASOS DEL TUTORIAL Paso 1: Preparación del entorno En este paso realizaremos las siguientes tareas: Descarga y descompresión del paquete del tutorial (página 8) Comprobación de los valores del sistema (página 8) Descarga e instalación de SharpDevelop (página 9) Instalación de Domain Class Coder (DCC) (página 9) Instalación de Strategy Class Coder (SCC) (página 9) Descarga y descompresión del paquete del tutorial El paquete ZIP que va a descargar contiene este PDF y todos los archivos necesarios para el tutorial (ver «Contenido del paquete del tutorial», página 4). Para descargarlo: 1 Vaya al portal de BioMA en la dirección 2 Vaya a la página Getting Started (introducción). 3 En la sección Tutorial 2 How to create a new component (cómo crear un componente nuevo), haga clic en el botón Download. 4 Descomprima el paquete TrainingCreateComponent.zip en una carpeta del PC. Comprobación de los valores del sistema Para seguir este tutorial, debe tener: un PC con Windows (por lo menos con 2/3 GB de RAM); derechos administrativos en el equipo; Microsoft.NET 3.5 (o superior) y un entorno de desarrollo integrado que puede ser - Visual Studio 2008/2010 o - SharpDevelop 5.0 Beta 1 (gratuito y de código abierto. Se puede descargar desde (Más abajo encontrará las instrucciones.) 8 Tutorial: Creación de componentes

11 PASO 1: PREPARACIÓN DEL ENTORNO Controladores para utilizar la base de datos SQL Server Compact Edition. Puede descargar los controladores desde: us/ download/details.aspx?displaylang=en&id=5783 En la configuración del PC, debe establecerse el punto (.) como separador de decimales. Para comprobar este valor: - Acceda al Panel de control de Windows (haga clic en el botón Inicio y después seleccione Panel de control > Reloj, idioma y región > Región e idioma.). - En la ventana Región e idioma, haga clic en Configuración adicional. - Compruebe que el valor de Símbolo decimal sea «punto» (.). Descarga e instalación de SharpDevelop Nota: Si Microsoft Visual Studio 2008 o superior está instalado en el PC, puede utilizarlo en lugar de SharpDevelop. El procedimiento de creación y edición de proyectos es similar en ambos. SharpDevelop es un entorno de desarrollo integrado gratuito y de código abierto que permite escribir aplicaciones en lenguajes como C#, VB.NET y Boo en la plataforma.net de Microsoft. Para instalar SharpDevelop: 1 Descargue la versión más reciente desde: 2 Siga las instrucciones para instalar la aplicación. Se creará un acceso directo en el escritorio. 3 Haga doble clic en el acceso directo para iniciar la aplicación. Instalación de Domain Class Coder (DCC) DCC es una aplicación Windows que permite generar código C# para utilizarlo como clases de dominio. Estas clases contienen los valores y los atributos de cada variable utilizada para modelar un dominio dado. Para instalar DCC: 1 Copie la carpeta DCC que encontrará en el paquete TrainingCreateComponent.zip en cualquier ubicación del equipo. Carpeta sugerida: C:\Program Files (x86)\jrc\dcc. Tutorial: Creación de componentes 9

12 2 PASOS DEL TUTORIAL 2 Dado que no es necesario instalarla, abra DCC ejecutando el archivo.exe que encontrará en la misma carpeta. Instalación de Strategy Class Coder (SCC) SCC es una aplicación Windows que facilita la implementación de una clase modelo (estrategia) de acuerdo con las especificaciones de la capa de modelado utilizada en la plataforma BioMA. SCC proporciona el código correspondiente generando una clase en código C#. Para instalar e iniciar SCC: 1 Ejecute el archivo setup.exe que está en la carpeta SCC del paquete TrainingCreateComponent.zip. 2 El software se instalará en la carpeta C:\Program Files (x86)\jrc\scc. El proceso de instalación creará un acceso directo en el escritorio. 3 Haga doble clic en el acceso directo para iniciar SCC. Instalación de Models Parameter Editor (MPE) MPE es una aplicación que crea de forma dinámica una interfaz gráfica de usuario para manejar los parámetros del modelo. 1 Ejecute el archivo setup.exe que está en la carpeta MPE del paquete TrainingCreateComponent.zip. 2 El software se instalará en la carpeta C:\Program Files (x86)\jrc\mpe. El proceso de instalación creará un acceso directo en el escritorio. 3 Haga doble clic en el acceso directo para iniciar MPE. Continúe con el siguiente paso: Paso 2: «Creación del proyecto en SharpDevelop», página Tutorial: Creación de componentes

13 PASO 2: CREACIÓN DEL PROYECTO EN SHARPDEVELOP Paso 2: Creación del proyecto en SharpDevelop Nota: Si Microsoft Visual Studio 2008 o superior está instalado en el PC, puede utilizarlo en lugar de SharpDevelop. El procedimiento de creación y edición de proyectos es similar en ambos. En este tutorial utilizaremos SharpDevelop para crear un componente capaz de simular el crecimiento de patógenos fúngicos en el suelo. Vamos a llamar MY.EXAMPLE.SoilBorne a este componente, y vamos a asignarle una estrategia (función matemática) llamada RGRYanHunt dado que sigue el algoritmo propuesto por Yan y Hunt (año) para el crecimiento de patógenos fúngicos en el suelo. En este caso, solo utilizamos una estrategia para compilar el componente, pero los componentes suelen contener más de una estrategia. En este paso realizará las siguientes tareas: Creación de un proyecto (página 11) Creación de una interfaz vacía (página 13) Definición de un método para la lógica de la estrategia (página 14) Creación del proyecto Para crear el proyecto en SharpDevelop: 1 Inicie SharpDevelop haciendo doble clic en el acceso directo creado en el escritorio después de instalarlo (ver «Descarga e instalación de SharpDevelop», página 9). 2 En la barra de menús de SharpDevelop, seleccione File > New > Solution. Aparecerá la ventana New Project: Tutorial: Creación de componentes 1 1

14 2 PASOS DEL TUTORIAL 3 Compruebe que, en el marco Categories, C# esté seleccionado para ver las opciones correspondientes a este lenguaje de programación en el marco Templates. 4 En el marco Templates, haga clic en Class Library. 5 En el cuadro de texto Name, introduzca MY.EXAMPLE.SoilBorne. Después, haga clic en Create. De forma predeterminada, el proyecto se guardará en la carpeta de proyectos de SharpDevelop, pero puede elegir cualquier otra. 6 En el panel izquierdo Projects, expanda la solución que acaba de crear: 1 2 Tutorial: Creación de componentes

15 PASO 2: CREACIÓN DEL PROYECTO EN SHARPDEVELOP 7 Haga clic en la clase que se ha creado automáticamente (es decir, My.Class.cs) como aparece más arriba, y haga clic en Delete. Creación de una interfaz vacía Para crear una interfaz vacía: 1 Seleccione el proyecto MY.EXAMPLE.SoilBorne en el marco Projects. 2 En la barra de menús de SharpDevelop, seleccione File > New > File. 3 En la ventana New File que aparecerá, haga clic en Interface. Tutorial: Creación de componentes 1 3

16 2 PASOS DEL TUTORIAL 4 En la ventana emergente que aparecerá, seleccione la opción Create a file inside project (crear archivo dentro del proyecto). 5 Haga clic en Create y, en el cuadro de texto File Name, introduzca ISoilBorneStrategy. Definición de un método para la lógica de la estrategia Dado que la nueva interfaz está vacía, es necesario definir un método que contenga la lógica principal de la estrategia cuyos argumentos serán las clases de dominio. Todavía no hemos creado las clases de dominio. Sin embargo, en este punto, vamos a suponer que quien crea el modelo sabe qué entradas/salidas necesita el componente. Por ejemplo, en el componente SoilBorne utilizaremos las siguientes clases de dominio como argumentos de nuestro método: algunos datos climáticos (clase de dominio Exogenous); algunos estados del modelo (clase de dominio States) y algunas tasas diarias (clase de dominio Rates) Además, sabemos que podría ser útil almacenar y utilizar los estados actuales y anteriores del modelo. Por esta razón, introducimos dos instancias de la clase de dominio States en la firma del método. 1 4 Nota: Pero ha sido una decisión nuestra. No es obligatorio. Si cree que en su modelo solo va a necesitar el estado actual, inserte una sola instancia de States. Tutorial: Creación de componentes

17 PASO 2: CREACIÓN DEL PROYECTO EN SHARPDEVELOP A efectos de este tutorial, crearemos el método Update, pero puede llamarlo como desee. Para definir el método, haga lo siguiente: 1 En el panel Projects de SharpDevelop, seleccione la interfaz vacía que ha creado en el paso anterior (ver «Creación de una interfaz vacía», página 13), es decir, ISoilBorneStrategy. Aparecerá lo siguiente: 2 Defina el método agregando las líneas de código requeridas: - Debajo de la instrucción using System; agregue using EC.JRC.MARS.ModelLayer.Strategy; - En la línea de la especificación public interface es necesario agregar :IStrategy - Por último, agregue la línea de especificación del método entre paréntesis: void Update(States s, Rates r, States s1, Exogenous ex); Los resultados serán entonces los siguientes : Tutorial: Creación de componentes 1 5

18 2 PASOS DEL TUTORIAL En nuestra convención, s representa el estado del paso anterior y s1 el estado del paso actual. Puede cambiar dichos nombres por otros de su preferencia. 3 En este punto, no se compilará el proyecto, dado que las clases de dominio todavía no se han definido. Para crear las clases de dominio es necesario utilizar DCC. Continúe con el siguiente paso: 1 Paso 3: «Creación de clases de dominio en DCC», página Tutorial: Creación de componentes

19 PASO 3: CREACIÓN DE CLASES DE DOMINIO EN DCC Paso 3: Creación de clases de dominio en DCC Para crear el modelo de un dominio, definimos tipos de datos llamados clases de dominio, de acuerdo con el procedimiento de Rizzoli et al. (1998). Las clases de dominio están caracterizadas por un conjunto de atributos de datos, las propiedades de los valores y un conjunto de métodos para establecer y obtener el valor, y para obtener los atributos. Una clase de dominio implementa la interfaz IDomainClass (definida en la biblioteca EC.JRC.MARS.ModelLayer.Core.dll). En nuestro ejemplo, utilizaremos DCC para generar las clases de dominio States, Rates y Exogenous del componente patógeno. DCC permite editar directamente las propiedades de las clases, así como cargar archivos de definiciones en formato XML. Sugerencia: Para obtener más información sobre cómo usar DCC, consulte la ayuda incorporada. Para acceder a ella, haga clic en el botón About y después haga clic en Help. En nuestro ejemplo, vamos a crear manualmente tres clases de dominio/propiedades: Exogenous/SoilTemperatureLayer1, SoilTemperatureLayer2 States/RelativeGrowth Rates/RelativeGrowthRate Para definir las clases de dominio: 1 Inicie DCC haciendo doble clic en el archivo.exe que se encuentra en la carpeta de instalación, normalmente C:\Program Files (x86)\jrc\dcc. (Si es necesario, consulte «Instalación de Domain Class Coder (DCC)», página 9.) 2 Aparecerá lo siguiente: Tutorial: Creación de componentes 1 7

20 2 PASOS DEL TUTORIAL 3 Defina la clase de dominio Exogenous: a. En el cuadro de texto domain class description, escriba Exogenous variables of CRA.Diseases.SoilBorne (Variables exógenas de CRA.Diseases.SoilBorne). b. En el cuadro de texto domain class name, escriba Exogenous. c. En el cuadro de texto name space, escriba MY.EXAMPLE.SoilBorne. d. Introduzca en la tabla los siguientes valores: 4 Compruebe que el botón de la opción Domain class esté seleccionado. Después, haga clic en el botón save XML. 1 8 Tutorial: Creación de componentes

21 PASO 3: CREACIÓN DE CLASES DE DOMINIO EN DCC 5 En la ventana Save As que aparece, busque y seleccione el directorio del proyecto ISoilBorneStrategy que creamos en SharpDevelop (ver «Creación de un proyecto», página 11). Como alternativa, puede elegir un subdirectorio del mismo proyecto. 6 Haga clic en el botón generate code. 7 Repita los pasos 3 a 6 para crear otras clases de dominio. Utilice lo siguiente como referencia para crear la clase de dominio Rates: Utilice lo siguiente como referencia para crear la clase de dominio States: Tutorial: Creación de componentes 1 9

22 2 PASOS DEL TUTORIAL 8 Cuando haya terminado, vuelva a SharpDevelop para incluir en el proyecto los archivos generados. Continúe con el siguiente paso: Paso 4: «Compilación del proyecto en SharpDevelop», página Tutorial: Creación de componentes

23 PASO 4: COMPILACIÓN DEL PROYECTO CON SHARPDEVELOP Paso 4: Compilación del proyecto en SharpDevelop Después de crear las clases de dominio en DCC, es necesario completar tres pasos en SharpDevelop para compilar el proyecto. Los pasos son: Agregar archivos al proyecto (página 21) Agregar al proyecto referencias a DLL ( página 22) Compilar el proyecto (página 22) Agregar archivos al proyecto En este paso agregaremos los seis archivos generados cuando creamos las clases de dominio en DCC, los archivos de dominio y VarInfo. Para agregar los archivos de las clases de dominio: 1 Vuelva a SharpDevelop o inícielo desde el acceso directo del escritorio. 2 En el panel Projects, haga clic con el botón derecho en el nombre del proyecto (MY.EXAMPLE.SoilBorne). Después seleccione Add > Existing Item en el menú emergente. 3 En la ventana Add existing files que aparecerá, seleccione C# Files (.cs) como tipo de archivo. Después vaya la carpeta del proyecto en la que guardó las clases de dominio. (Ver «Para definir las clases de dominio», página 17.) 4 Agregue los seis archivos.cs (clases de dominio y VariInfo) que generó en DCC. Seleccione todos los archivos y haga clic en Open. 5 En este punto, si guardó los archivos.cs en una carpeta distinta de la carpeta del proyecto, aparecerá una ventana en la que se le preguntará si desea copiar los archivos en el directorio de destino o si desea crear vínculos a la ubicación actual. Seleccione la opción de copia de los archivos. Al final, el resultado debe ser el siguiente: Tutorial: Creación de componentes 2 1

24 2 PASOS DEL TUTORIAL Agregar al proyecto referencias a DLL En este paso referenciaremos las DLL de la capa del modelo, que puede encontrar dentro del paquete del tutorial. Para agregar las referencias a las DLL: 1 En el panel Projects, haga clic con el botón derecho en la carpetareferences que está bajo MY.EXAMPLE.SoilBorne. Después, seleccione Add Reference. 2 En la ventana Add References que aparecerá, seleccione la pestaña.net Assembly Browser. 3 Busque la carpeta TrainingCreateComponent. Después, abra la subcarpeta Libraries y seleccione las siguientes DLL: - EC.JRC.MARS.MetadataTypes.dll - EC.JRC.MARS.ModelLayer.Core.dll - EC.JRC.MARS.ModelLayer.Strategy.dll - EC.JRC.MARS.ParametersManagement.dll 4 Haga clic en el botón OK, situado en la esquina inferior derecha de la ventana Add references. Compilar el proyecto En este paso, va a compilar el modelo y cambiar los valores predeterminados de SharpDevelop. 2 2 Tutorial: Creación de componentes

25 PASO 4: COMPILACIÓN DEL PROYECTO CON SHARPDEVELOP Para compilar el proyecto: 1 En el panel Projects, haga clic con el botón derecho en el nombre del proyecto (MY.EXAMPLE.SoilBorne) y seleccione Build. El proyecto debe compilarse correctamente. Sin embargo, de forma predeterminada, SharpDevelop creará un proyecto para.net Framework 4. Debe cambiarse este valor dado que todo en BioMA se compila con.net Framework Haga clic con el botón derecho en el nombre del proyecto y después, seleccione Properties. 3 Seleccione la pestaña Compiling y después, haga clic en el botón Change situado al lado del valor Target Framework : 4 En la pestaña Project Upgrade que aparecerá, establezca lo siguiente: a. De la lista desplegable Convert selected projects to, seleccione C# 3.0. b. De la lista desplegable Change target framework, seleccione.net Framework Haga clic en Convert. 6 En el panel Projects situado a la izquierda, haga clic con el botón derecho en el nombre del proyecto y seleccione Rebuild. Tutorial: Creación de componentes 2 3

26 2 PASOS DEL TUTORIAL 7 No cierre el proyecto SharpDevelop, porque volveremos a él más tarde. Continúe con el siguiente paso: Paso 5: «Creación de estrategias en SCC», página Tutorial: Creación de componentes

27 PASO 5: CREACIÓN DE ESTRATEGIAS EN SCC Paso 5: Creación de estrategias en SCC Una vez creada la DLL que contiene las clases de dominio y las interfaces, utilizaremos la aplicación SCC para generar el esqueleto y el código de acuerdo con la arquitectura adoptada. Esto permite a quien crea los modelos centrarse en la implementación del algoritmo de esos modelos. Se recomienda poner las clases de dominio y las estrategias en proyectos distintos. Por tanto, antes de iniciar SCC, crearemos un proyecto nuevo en SharpDevelop que contendrá las estrategias. Para crear un proyecto nuevo en SharpDevelop que contenga las estrategias: Repita el paso «Creación de un proyecto» de la página 11, pero dé un nombre nuevo al proyecto; es decir, agregue Strategies al final para indicar que es el que contiene las estrategias. En nuestro caso, el nombre del proyecto nuevo será: MY.EXAMPLE.SoilBorne.Strategies. Nota importante Recuerde convertir el proyecto nuevo a.net Framework 3.5, tal como hizo con el proyecto MY.EXAMPLE.SoilBorne. Para obtener instrucciones detalladas, ver «Compilación del proyecto», página 22. Para crear estrategias en SCC 1 Inicie SCC desde el acceso directo del escritorio. Sugerencia: Para obtener más información sobre cómo usar SCC, consulte la ayuda incorporada. Para acceder a ella, haga clic en el botón About y después haga clic en Help. 2 Cargue las clases de dominio que se crearon y compilaron: a. Haga clic en el botón Data Interfaces DLL. b. Busque la carpeta MY.EXAMPLE.SoilBorne\MY.EXAMPLE.SoilBorne\bin\Debug\ y seleccione MY.EXAMPLE.SoilBorne.dll: Tutorial: Creación de componentes 2 5

28 2 PASOS DEL TUTORIAL 3 En la pestaña General, compruebe que ha establecido los siguientes parámetros: Domain y Model Type: las listas desplegables incluyen una serie de opciones (por ejemplo, Soil/Plant o Create a new domain). Seleccione una opción para ambos casos. Namespace: introduzca MY.EXAMPLE.SoilBorne.Strategies. Es el mismo nombre del proyecto que se creó anteriormente. (Ver «Para crear un proyecto nuevo en SharpDevelop que contenga las estrategias», página 25.) Strategy name: introduzca RGRTRYanHunt. 4 Establezca los otros valores generales de acuerdo con sus preferencias. 5 Seleccione la pestaña Inputs Outputs para definir las entradas y las salidas de la estrategia. 6 En la lista desplegable Domain class, seleccione la primera clase de dominio, por ejemplo, states MY.EXAMPLE.SoilBorne.States: 2 6 Tutorial: Creación de componentes

29 PASO 5: CREACIÓN DE ESTRATEGIAS EN SCC Después de seleccionar la clase de dominio, debajo aparecerá la lista de variables: 7 Seleccione una variable de la lista. 8 Seleccione el botón de opción Input o Output, según se requiera. En este caso, utilice lo siguiente como referencia: - Para la clase de dominio states, el valor disponible para RelativeGrowth es una salida. - Para las clases de dominio states1 y rates, las variables son salidas. - Para la clase de dominio exogenous, las variables son entradas. 9 Haga clic en el botón Select Variable para mover el elemento al marco Inputs o al marco Outputs situado a la derecha. Tutorial: Creación de componentes 2 7

30 2 PASOS DEL TUTORIAL 10 Para eliminar una fila de Inputs o Outputs, seleccione la fila y pulse la tecla Supr. 11 Repita los pasos 6 a 9 para cada clase de dominio. 12 Seleccione la pestaña Parameters y establezca los siguientes valores: 13 Haga clic en el botón Generate code situado en la parte inferior de la ventana para generar el código de la clase. 14 En la ventana Save As que aparecerá, guarde el código en el directorio del proyecto MY.EXAMPLE.SoilBorne.Strategies con el nombre RGRTRYanHunt.cs. 15 En la ventana emergente, haga clic en Yes si desea ver el código generado en este momento. En caso contrario, haga clic en No. 16 Para guardar la configuración actual y utilizarla en el futuro, haga clic en el botón Save definition situado en la parte superior izquierda de la ventana. Continúe con el siguiente paso: Paso 6: «Compilación de los proyectos en SharpDevelop», página Tutorial: Creación de componentes

31 PASO 6: COMPILACIÓN DE LOS PROYECTOS EN SHARPDEVELOP Paso 6: Compilación de los proyectos en SharpDevelop En este paso, realizaremos tres tareas: Agregar el archivo SCC al proyecto (página 29) Agregar las referencias a DLL (página 30) Compilar los dos proyectos (página 31) Agregar el archivo SCC al proyecto En esta tarea agregaremos el archivo de estrategias que generamos con SCC en el paso 5 al proyecto creado en SharpDevelop. (Ver «Para crear un proyecto nuevo en SharpDevelop que contenga las estrategias», página 25. Para agregar el archivo SCC: 1 Vuelva a SharpDevelop. 2 En el panel izquierdo Projects, haga clic con el botón derecho en el proyecto MY.EXAMPLE.SoilBorne.Strategies. 3 En el menú emergente, seleccione Add > Existing item. 4 En la ventana que aparecerá, seleccione C# Files (*.cs) como tipo de archivo. Después, busque y seleccione el archivo RGRTRYanHunt.cs. Como resultado, la solución ShapDevelop se parecerá a lo siguiente en el panel Projects: Tutorial: Creación de componentes 2 9

32 2 PASOS DEL TUTORIAL Agregar referencias a DLL En esta tarea agregaremos al proyecto las referencias a DLL necesarias. Para agregar las referencias: 1 En el panel izquierdo Projects, haga clic con el botón derecho en la carpeta References que está bajo el proyecto MY.EXAMPLE.SoilBorne.Strategies. 2 En el menú emergente, seleccione Add Reference. 3 En la ventana Add Reference que aparecerá, seleccione la pestaña.net Assembly Browser. 4 Haga clic en el botón Browse. Después, vaya a la carpeta en la que descomprimió el paquete TrainingCreateComponent que le proporcionamos. 5 En la subcarpeta Libraries, seleccione las siguientes DLL: - EC.JRC.MARS.MetadataTypes.dll - EC.JRC.MARS.ModelLayer.Core.dll - EC.JRC.MARS.ModelLayer.Strategy.dll 3 0 Tutorial: Creación de componentes

33 PASO 6: COMPILACIÓN DE LOS PROYECTOS EN SHARPDEVELOP - EC.JRC.MARS.ParametersManagement.dll Para seleccionar una DLL, haga clic sobre ella, haga clic en Open y después, en OK. 6 Ahora seleccione la pestaña Projects y seleccione el proyecto MY.EXAMPLE.SoilBorne que contiene las clases de dominio. 7 Haga clic en el botón OK. Como resultado, la solución ShapDevelop se parecerá a lo siguiente en el panel Projects: Compilar los dos proyectos En este paso cambiaremos los valores predeterminados de SharpDevelop y después, compilaremos los dos proyectos. Para cambiar los valores y compilar los proyectos: 1 Cambie el valor predeterminado de SharpDevelop a.net Framework 3.5. Para ello, repita el procedimiento descrito en «Compilación del proyecto», página En el panel Projects, haga clic con el botón derecho en el nombre de proyecto MY.EXAMPLE.SoilBorne y después, seleccione Build. 3 Repita la misma operación para el proyecto MY.EXAMPLE.SoilBorne.Strategies. Ambos proyectos deberían compilarse correctamente. Continúe con el siguiente paso: Paso 7: «Introducción del código del modelo en SharpDevelop», página 32 Tutorial: Creación de componentes 3 1

34 2 PASOS DEL TUTORIAL Paso 7: Introducción del código del modelo en SharpDevelop Quienes crean modelos tienen que escribir el algoritmo dentro del marcador de posición del código que se ha generado; es decir, implementar el método Estimate de la clase RGRTRYanHunt. Para introducir el código del modelo: 1 En el panel Projects de SharpDevelop, seleccione la clase RGRTRYanHunt. 2 En el panel del código de la clase RGRTRYanHunt, busque el método Estimate: 3 Abra el archivo CodeOfMethodEstimate_toBeCopiedInTheStrategy.txt proporcionado con el paquete de formación y después, copie y pegue el código bajo las líneas de comentario (en verde). 4 Cuando haya terminado, vuelva a compilar ambos proyectos: en el panel Projects, haga clic con el botón derecho en cada proyecto y después, seleccione Rebuild. Continúe con el siguiente paso: Paso 8: «Creación de la clase parámetros para la estrategia», página Tutorial: Creación de componentes

35 PASO 8: CREACIÓN DE LA CLASE PARÁMETROS PARA LA ESTRATEGIA Paso 8: Creación de la clase parámetros para la estrategia En este paso realizaremos las siguientes tareas: Crear la clase parámetros con DCC (página 33) Agregar la clase parámetros al proyecto (página 34) Crear la clase parámetros con DCC Para crear la clase parámetros: 1 Inicie DCC haciendo doble clic en el archivo.exe de la carpeta de instalación. 2 En la parte inferior de la ventana DCC, seleccione el botón de la opción Parameters class. 3 Haga clic en el botón Load parameters class from strategy (cargar la clase parámetros desde la estrategia). Nota: Si aparece un mensaje de advertencia, compruebe que ha convertido los dos proyectos a.net 3.5 Framework. Si no lo ha hecho, siga las instrucciones que encontrará en «Compilación del proyecto», página 22, antes de continuar. 4 En la ventana que aparecerá, busque la carpeta del proyecto (...\MY.EXAMPLE.SoilBorne.Strategies\bin\debug), y después, seleccione el archivo MY.EXAMPLE.SoilBorne.Strategies.dll. 5 En la ventana emergente Strategy class loader que aparecerá, seleccione MY.EXAMPLE.SoilBorne.Strategies.RGRTRYanHunt en la lista desplegable. Como resultado, en DCC aparecerán los parámetros de la estrategia. Nota: Deje abierta la ventana emergente Strategy class loader. Tutorial: Creación de componentes 3 3

36 2 PASOS DEL TUTORIAL 6 Haga clic en el botón Generate code y después, busque la carpeta MY.EXAMPLE.SoilBorne.Strategies. De esta forma, la clase se generará dentro de la carpeta del proyecto. El nombre de archivo de la clase se guardará automáticamente con el nombre RGRTRYanHunt_Parameters.cs. 7 Por último, guardaremos la clase parámetros en formato XML. Para ello, haga clic en el botón Save XML. 8 En la ventana emergente que se abrirá, busque la carpeta MY.EXAMPLE.SoilBorne.Strategies, dé al archivo el nombre RGRYanHunt_ParametersDCC.xml y haga clic en Save. Agregar la clase parámetros al proyecto Para agregar la clase parámetros al proyecto en SharpDevelop: 1 Vuelva a SharpDevelop. 2 En el panel izquierdo Projects, haga clic con el botón derecho en el proyecto MY.EXAMPLE.SoilBorne.Strategies y después, seleccione Add > Existing item. 3 Establezca C# Files (*.cs) como tipo de archivo y después, seleccione el archivo RGRTRYanHunt_Parameters.cs que creó anteriormente con DCC. Como resultado, el panel Projects aparecerá así: 3 4 Tutorial: Creación de componentes

37 PASO 8: CREACIÓN DE LA CLASE PARÁMETROS PARA LA ESTRATEGIA 4 Para completar el procedimiento, vuelva a compilar ambos proyectos: en el panel Projects, haga clic en cada proyecto (MY.EXAMPLE.SoilBorne y MY.EXAMPLE.SoilBorne.Strategies) y seleccione Rebuild. 5 Espere hasta que se compilen correctamente. Continúe con el siguiente paso: Paso 9: «Creación del archivo de parámetros para la estrategia», página 36 Tutorial: Creación de componentes 3 5

38 2 PASOS DEL TUTORIAL Paso 9: Creación del archivo de parámetros para la estrategia En este último paso, crearemos un archivo de parámetros que contenga los valores de los parámetros de la estrategia. Es necesario hacerlo porque, cuando se ejecuta el modelo, la clase parámetros creada en el paso 8 (RGRTRYanHunt_Parameters) lee esos valores. En los archivos de parámetros, el usuario utiliza el Model Parameter Editor (MPE) para definir los conjuntos de valores de los parámetros. Para definir los valores y crear el archivo de parámetros utilizando MPE: 1 Inicie MPE haciendo doble clic en el acceso directo que se creó durante el proceso de instalación. (Si es necesario, vea «Instalación de Models Parameter Editor (MPE)», página 10.) 2 EN la barra de menús de MPE, seleccione File > Import types > XML DataSet. 3 Busque y seleccione el archivo RGRYanHunt_ParametersDCC.xml creado en el paso anterior (ver paso 8). 4 Para agregar una clave nueva, haga clic en el botón situado en la parte superior de MPE. 5 En la ventana emergente Add new key value que aparecerá, introduzca un nombre y una descripción para la clave nueva y haga clic en OK. Como resultado, aparecerán en la tabla los tres parámetros de la estrategia. 6 Haga doble clic en la primera fila de parámetros para que aparezca la ventana emergente VarInfo viewer que muestra el rango de valores permitidos: 3 6 Tutorial: Creación de componentes

39 PASO 9: CREACIÓN DEL ARCHIVO DE PARÁMETROS PARA LA ESTRATEGIA 7 En el panel Values situado a la derecha, introduzca el valor que desea definir para la clave del parámetro. 8 Repita los pasos 6 y 7 para los tres parámetros. (Tenga en cuenta que una vez introducido el valor de un parámetro en el panel Values de la derecha, el valor desaparece después de hacer clic en otra fila de la lista. Sin embargo, el valor especificado se ha asignado correctamente al parámetro, y puede introducir el siguiente). 9 Por último, guarde el archivo en formato XML: en la barra de menús de MPE, seleccione File > Write values > XML. 10 Busque una carpeta de su elección y haga clic en OK. Aparecerá una ventana emergente de confirmación. El nombre de archivo se ha asignado automáticamente, de acuerdo con el nombre de la estrategia. Por ejemplo: MY.EXAMPLE.SoilBorne.Strategies_RGRTRYanHunt.xml, que es el nombre completo de la estrategia y el resultado de este paso. Sugerencia: En este paso hemos agregado una clave nueva. Sin embargo, los usuarios pueden agregar más claves. Para obtener información sobre cómo hacerlo, consulte la Guía de usuario incorporada a la que se accede haciendo clic en el botón Help de la barra de menús: Tutorial: Creación de componentes 3 7

40 2 PASOS DEL TUTORIAL Cuáles son los próximos pasos? En este tutorial hemos creado un componente nuevo que incluye una estrategia. Sin embargo, para compilar una solución de modelado para un propósito específico, debe conectar entre sí más componentes del modelo y definir en qué orden se ejecutarán. Cada componente contiene entradas, salidas, parámetros, etc. específicos. Con este objetivo, siga las instrucciones proporcionadas en Tutorial Creating a modeling solution, adaptado a usuarios avanzados (como quienes crean modelos) que desean crear sus propias soluciones de modelado. 3 8 Tutorial: Creación de componentes