Introduction

What is Necada

NECADA is an optimization software designed to find optimal designs in compliance with the rules of sustainability, minimizing the environmental, economic and social impacts throughout the entire life cycle of the building. Its computing power derives from the possibility of running simulations in cloud, cluster or desktop environments. The objective of this infrastructure is to find optimal values for various construction parameters and their associated impacts that reduce the demand or energy consumption of the building or urban area.

El texto anterior lo copié desde la pagina principal de Optisim, habría que completarlo

Public and private content

Rellenar

Types of users

There are three types of users in Necada:
  • Not logged users
  • Company users
  • Results Viewer users

Not logged users

Los usuarios no loginados pueden ver unicamente la parte pública de Necada, ya sean ficheos IDF, proyectos, experimentos, materiales.

No podrán ver el contenido que los usuarios de Optisim hayan marcado como privada.

Company users

Pueden ver el contenido marcado como público de cualquier usuario y todo el contenido privado que hayan creado ellos mismos.

Puede subir ficheros IDF, crear experimentos, ejecutarlos y ver los resultados de esos experimentos.

Puede crear usuarios de tipo Results Viewer y asignarlos a determinados proyectos, para que puedan consultar los resultados de los experimentos que contengan esos proyectos.

Results Viewer users

Pueden ver el contenido marcado como público de cualquier usuario.

Pueden ver el contenido privado de proyectos cuyo propietario les haya dado permisos de lectura, pero no podrán modificar nada.

How to obtain an account

To obtain a Necada account you can complete this form:
Get a Necada account

Necada Tour

Introduction

This section describes the basic elements needed in order to execute an experiment on the NECADA infraestructure for registered Company type users .

To obtain a Necada account follow the instructions described in the section How to obtain an account.

We will see:

  • How to upload an IDF Model file (Energy Plus Input Data File)
  • How to create a Project
  • How to create an Experiment
  • How to create a Permutation
  • How to execute an Experiment
  • How to view the results of an Experiment
  • How to create a Results Viewer user and assign it to the Project

Login

Si no está loginado, la pantalla inicial de Necada tendrá este aspecto:

Necada Homescreen

Deberá introducir su usuario y contraseña. Si es correcta, verá el Dashboard de Necada:

Necada Dashboard Empty for loggined user

En la parte superior derecha aparece el nombre del usuario, en este ejemplo Company1.

Si el usuario ya tuviese experimentos ejecutados, los veria listados, y el resultado del último experimento:

Necada with an executed experiment

Uploading an IDF Model file

En el paso anterior hicimos login en Optisim. Si es la primera vez que entramos en la aplicación, no tendremos datos con los que trabajar. Por tanto, lo primero que haremos será subir un modelo del edificio a optimizar mediante un fichero Energy Plus Input Data File (IDF) . Muchos programas permiten exportar a este formato.

Desde el menú BIM Models elegimos la opción Building Models:

Menu Building Models

Se nos mostrará el listado de modelos IDF que hayamos subido:

Building Models List Not Empty

En nuestro caso, dado que no hemos subido ningún modelo IDF, veremos el listado vacío:

Building Models List Empty

Por tanto, clicamos en el botón 'Upload a new one'. Se abrirá el siguiente formulario:

Import a new Building Model Empty Form

Debera rellenar los campos Name and Description. En Model file deberá navegar hasta la carpeta donde tenga guardado su fichero del modelo (fichero IDF) y seleccionarlo. El formulario, una vez rellenado tendrá un aspecto similar a este:

Import a new Building Model Filled Form

Es importante considerar el último campo Make this model public. Si está desactivado, el modelo será privado, es decir, sólo visible para el usuario. Si está activado, el modelo será público, es decir, visible para todos los usuarios (tanto si están registrados en Necada como si entra de forma anónima).

Public or Private Content

A posterior, el usuario podrá cambiar este campo de privado a público si lo desea. Pero el proceso inverso, es decir, de público a privado, no será posible (deberá contactar con el administrador de Necada).

Si ahora se clica el botón Upload Model se añadirá el modelo IDF al sistema Necada. El proceso puede tardar unos segundos. Mientras, se bloqueará la aplicación y se mostrará un mensaje:

Operation in Course

Si la carga termina correctamente, se mostrará un mensaje indicándolo:

Building Model Created in Necada

Nos aparecen dos nuevos campos: Test status y Validated. Para poder usar el modelo IDF en experimentos, debe estar Validated. Ahora veremos esto con detalle.

Not tested nor validated

Si volvemos al listado de modelos IDF veremos el modelo que acabamos de importar:

Building Models List Not Tested and Not Validated

IDF Model tested and validated

Como se ha comentado, para poder usar el modelo IDF en proyectos y experimentos, el modelo IDF debe estar en estado Validated. De esto se encarga Optisim de manera automática.

Cada vez que el usuario sube un nuevo modelo IDF, Optisim crea un experimento de validación. Todos los experimentos de validación se agrupan en un mismo proyecto llamado BIM Validation Reports.

Los proyectos se muestran clicando en la opción de menú Projects:

Projects Menu

Dado que aún no hemos creado ningún proyecto, sólo se mostrará el proyecto BIM Validation Reports:

BIM Validation Reports Project

Si clicamos en el link marcado en azul, veremos el detalle de ese proyecto:

BIM Validation Reports Detail

Ahora clicamos en la pestaña Experiments donde veremos el experimento de validación que Optisim ha creado para el modelo IDF que hemos subido:

BIM Validation Reports Experiments

Nos interesa la columna Status. Pueden haber tres estados: Running, Completed Ok or Completed Error.

BIM Validation Reports Experiments Status

Si ve el estado en Running, tendrá que esperar unos minutos a que termine de ejecutarse ese experimento.

Si ve el estado Completed Error es que el modelo IDF no es correcto desde el punto de vista de Optisim. No se podrá utilizar para crear experimentos.

Si ve el estado Completed Ok entonces el modelo IDF es correcto y ya se puede usar para crear experimentos en Necada. En este caso, si vuelve al listado de modelos IDF verá que el estado de su IDF ha cambiado:

Building Models List Tested and Validated

How to create a Project

Ahora que ya tenemos un modelo IDF, podemos crear un Proyecto, a partir del cual crearemos Experimentos. Para ello hay que clicar en el menú Projects:

Projects Menu

Nos mostrará el listado de proyectos. De momento sólo existe uno, BIM Validation Project, creado por Necada:

Projects List

Podemos añadir uno clicando el botón Create a new one:

Create a Project's empty form

Debemos rellenar los campos Name, Description y Public/Private:

Create a Project's filled form

Recordar que, una vez creado el proyecto, el usuario sólo podrá cambiar el campo Public/Private de Privado a Público. Una vez es Público, ya no se puede cambiar a privado. Y todo lo que es público es visible por cualquier usuario, aunque no esté registrado en Necada.

Checkbox to create a Public/Private project

En este ejemplo lo hemos dejado como privado (desactivado), de forma que este proyecto sólo será visible para el usuario que lo ha creado (y para los usuarios de tipo Results Viewer) que crearemos en el último paso de este tutorial.

Si clicamos el botón Create Project, se creará el proyecto y nos mostrará el detalle de ese proyecto, así como un mensaje indicando que se ha creado correctamente:

Project created ok

Si volvemos al listado de proyectos, veremos dos proyectos, el BIM Validation Project creado automáticamente por Necada, y el proyecto que hemos creado nosotros:

Project List with two projects

Una vez creado el proyecto, antes de crear experimentos, es necesario asociar el experimento con un modelo IDF, con un Weather y añadir alguna solución constructiva.

Para añadir un modelo IDF clicaremos en la pestaña Building Models. Como vemos, no hay ninguno:

Empty Building Models List of this Project

Clicamos el botón Assign a new Building Model

Choose one building model

Dado que sólo tenemos un building model (al que pusimos como nombre IDF), lo elegimos y clicamos el botón Associate. Se mostrará un mensaje de que ha ido todo bien y se mostrará el model IDF añadido al proyecto:

Building Models List of this Project with one model

Ahora añadimos una solución constructiva, clicando en la pestaña Constructing Solutions. Nos mostrará un llistado con las soluciones constructivas del modelo IDF elegido en la pestaña Building Models:

Associate a Constructing Solution for this Project

En este ejemplo elegiremos Fachada Aislamiento Exterior[127]. El texto Fachada Aislamiento Exterior es el nombre de la solución constructiva en el fichero IDF. El texto [127] es el identificador que el sistema Necada le asocia al modelo IDF. Este identificador permite distinguir dos soluciones constructivas con el mismo nombre, pero que pertenezcan a dos modelos IDF distintos.

Si clicamos el botón Associate veremos la solución constructiva elegida añadida al Project:

Constructing Solution associated to the Project

Seguidamente le asociaremos un fichero de clima, clicando en Weather data. Como vemos, el listado está vacío:

Empty Weather Data list for this Project

Los Weather data son ficheros con datos de climatologia. El usuario puede subir sus propios ficheros, aunque el administrador de Necada ya ha subido ficheros de varias regiones de España. Bastará elegir uno que se corresponda con la zona climática donde se ubicaría el edificio a simular.

Para ello clicaremos en Assign a new Weather Data y elegiremos Barcelona.

Associate a existing Weather Data

El listado de Weather Datas muestra ahora una línea:

Not empty Weather Data list for this Project

Una vez asigandos estos tres elementos (modelo IDF, Constructing Solution y Weather Data), ya podemos crear un experimento. Eso lo haremos en el siguiente paso.

How to create an Experiment

Para crear un experimento, nos iremos a la pestaña Experiments:

Experiments list empty

Como vemos, no hay ningún experimento.

Para crear uno pulsaremos el botón Create a New Experiment.

New Experiment empty

Debemos darle un Name y Description. Decidir si es publico o privado. Y elegir el modelo IDF que servirá de base para los experimentos. El formulario rellenado tendría este aspecto:

New Experiment filled

¿Recordamos la pestaña Building Models del Project?

Building models of this project

En el campo Model Name podremos elegir uno de los modelos disponibles en el listado anterior. En nuestro ejemplo sólo hay un modelo, llamdo IDF, así que lo seleccionamos.

Si pulsamos Create Experiment se creará el experimento y veremos el detalle:

Experiment detail

Si miramos de nuevo la lista de experimentos del proyecto, veremos que ahora sí aparece una línea:

Project's Experiments list Not empty

El siguiente paso será crear permutaciones.

How to create an Stage (or Permutation)

Desde el detalle de un experimento:

Experiment detail

pulsamos la pestaña Permutations:

Experiment Permutations

Este formulario es bastante complejo, en apariencia.

Consta de cuatro partes:

a) Carga de un fichero de permutaciones:

Upload Perm file

b) Descarga del fichero de permutaciones:

Download Perm file

c) Parametros de optimización

Optimization parameters

d) Definición de escenarios (también llamados Permutations):

Permutations

En este tutorial nos centraremos solo en el último punto, la creación de escenarios.

En primer lugar, tenemos que añadir el modelo IDF al Experiment (recordar que primero se añadió al Project). Para ello pulsamos el botón New Model

Add a model file to the experiment

Sólo nos mostrará los modelos que se hayan añadido al Project (pestaña Building Models).

En nuestro caso, elegiremos el unico modelo disponible, IDF, y pulsaremos el botón Add. Nos mostrará un mensaje de que se ha añadido correctamente:

New Model added to the Experiment:  message

Y podemos ver la nueva permutación Group. Si clicamos en Group se expande al detalle, mostrando el nombre del modelo IDF:

Permutation detail

Seguidamente añadimos un fichero de Weather (de los disponibles en el Project):

Add new Weather

En nuestro caso, elegiremos el único valor disponible, Barcelona.

Nos mostrará un mensaje de que se ha añadido correctamente:

New Weather Data added

Y veremos la nueva permutación como un segundo Group, sobre el que podemos clicar y ver el detalle:

Not empty

Hasta ahora nos hemos limitado a repetir los pasos que ya dimos con el Project. Nos falta añadir la solución constructiva.

El objetivo de Necada es permitir elegir qué solución constructiva es más adecuada en términos de ahorro de energía. Por tanto, nos interesa comparar la solución constructiva que se eligió al crear el Project con otras soluciones constructivas (ya sean importadas de algún modelo IDF o creadas por el usuario o públicas de cualquier usuario) de forma que veamos cuál es más eficiente.

De hecho Necada permite comparar cualquiera de los elementos disponibles. Por ejemplo, se podría rotar el edificio para comprobar si con otra orientación sería más eficiente (por ejemplo, porque recibe más horas de sol en sus ventanas), o se podría cambiar la climatología para ver si ese edifició se comporta mejor en un ambiente húmedo o seco.

En ese ejemplo, sin embargo, nos centraremos sólo en permutar la solución constructiva elegida en el proyecto, permutándola con otras dos soluciones constructivas ya existentes.

Por tanto, clicamos el botón New Solution. Nos aparece el siguiente formulario:

First Constructing Solution

Como vemos, en el primer desplegable sólo se ve una solución constructiva Fachada Aislamiento Exterior[127]. Es la misma solución constructiva que se eligió al crear el Project (pestaña Constructing Solutions). Por tanto, elegimos esa solucion constructiva.

Ahora abrimos el segundo desplegable. Nos muestra todas las soluciones constructivas del usuario (tanto publicas como privadas) y las públicas del resto de usuarios:

Second Constructing Solution

Elegimos una cualquiera, por ejemplo Fachada doble hoja[127].

Not empty

Con esto buscamos saber qué ahorro energético tendríamos si cambiasemos Fachada Aislamiento Exterior[127] por Fachada doble hoja[127] en el edificio definido en el modelo IDF, para la zona climática elegida.

Si clicamos en Add nos mostrará un mensaje de que se ha añadido correctamente, pero con una advertencia sobre parámetros de sostenibilidad no definidos. Este mensaje puede ser bastante largo, en la imagen ha sido acortado. Lo importante es que la permutación se ha añadido correctamente.

New Construction Solution added

Y veremos la nueva permutación como un tercer Group, sobre el que podemos clicar y ver el detalle:

Not empty

Vemos que aparecen otros elementos, Headers, Sustainability solutions y Sustainability materials que son temas avanzados.

Vamos a añadir otra permutacion de tipo solución constructiva, por ejemplo Fachada Aislamiento Exterior[127] con Fachada entramado madera[127].

New Constructing Solution Permutation

Ahora podemos ver dos cosas. Primero, el número de permutaciones ha aumentado a 2. Segundo, no hay ningún Group nuevo, pero si vemos el detalle del tercero (el de las soluciones constructivas), vemos que aparece una nueva línea para la Fachada entramado madera[127], la última permutación que le añadimos a la solució constructiva Fachada Aislamiento exterior[127].

Two permutations

Cada permutación (o escenario) tiene un coste de ejecución que el usuario deberá pagar antes de ejecutar el experimento. Cuantas más permutaciones tenga el experimento, más costará ejecutarlo.

En el siguiente punto veremos como ejecutar en un experimento.

How to execute an Experiment

Si clicamos en la pestaña Execution veremos la siguiente pantalla:

Execute an Experiment

Podemos ver que el experimento tiene dos permutaciones. Si lo queremos ejecutar, basta con clicar el botón Execute this experiment, y Necada mostrará un mensaje de confirmación:

Execute an Experiment: confirmation

Si se clica en Execute nos muestra el coste total del experimento:

Execute an Experiment: payment

Si se clica en Buy Now nos llevará a la página de pago por PayPal. Si pagamos, volveremos a la aplicación Necada y el experimento empezará a ejecutarse.

Execute an Experiment: Queued

A partir de ahí irá cambiando de estado (puede tardar bastante si la simulación es costosa en tiempo):

Execute an Experiment: Queued Execute an Experiment: Executing Execute an Experiment: Retrieving Results

Y ahora o termina correctamente:

Execute an Experiment: Ended ok

O termina con errores:

Execute an Experiment: Ended with errors

En este ejemplo supondremos que terminó correctamente. Por tanto, el siguiente paso será ver los resultados.

How to view the results of an Experiment

Dado que el experimento terminó su ejecución correctamente, vamos a ver los resultados. Para ello nos iremos a la pestaña Results del Experiment:

Execute an Experiment: Results

Aquí tenemos los ficheros generados por Plotly (gráficas HTML):

Execute an Experiment: Results as HTML Plotly files

Aquí tenemos los ficheros con datos en formato R que se pueden descargar:

Execute an Experiment: Results as R files

Finalmente, la lista de escenarios (o permutaciones):

Execute an Experiment: Permutation list

HABRIA QUE AÑADIR EXPLICAR LAS DIVERSAS GRAFICAS Y FICHEROS R DISPONIBLES. LO DEJO PARA QUIEN HAGA LA TRADUCCIÓN AL INGLES.

How to create a Results Viewer user and assign it to the Project

Para el cliente podría ser adecuado permitir que otras personas pudiesen consultar los resultados de su experimento. Si el experimento es público, cualquier usuario lo podrá consultar (aunque no esté registrado en Necada).

Pero si el experimento es privado, el único usuario que lo puede ver es el propietario. Y dado que la cuenta del usuario es personal e intransferible, es necesario que el propietario pueda crear usuarios que sólo podrán ver los resultados de los experimentos a los que el usuario desee dar acceso.

Estos usuarios que sólo pueden consultar datos se les denomina Results Viewers. Veamos como crear un usuario de este tipo.

En el menú del usuario (Company1) elegir la opción My Users:

Se mostrará el listado de usuarios de tipo Results Viewer creados por usuario (Company1 en nuestro ejemplo):

Como se ve, no hay ningún usuario definido aún. Vamos a crear uno, pulsando el botón Create a new one. Se mostrará el formulario:

Se debe introducir un Username y un email. En ese email, el futuro usuario Results Viewer recibirá un link que le llevará a Necada, donde deberá introducir el password con el que acceder a Necada.

Por ejemplo, ponemos como Username el valor ResultsViewer1, y como email el del futuro usuario:

Si pulsamos el botón Create User, se mostrará el nuevo usuario:

Notar que el email aparece en color rojo. Eso se debe a que el nuevo usuario Results Viewer ha recibido un email similar a este:

El futuro usuario Results Viewer sólo tiene que clicar en el link y le mostrará una pantalla similar a esta:

Una vez el nuevo usuario Results Viewer introduzca el password que quiere usar, se le mostrará esta pantalla:

Ahora el nuevo usuario Results Viewer ya puede hacer login.

Volviendo a listado de usuarios Results Viewer, ahora el email ha cambiado a verde, indicando que el nuevo usuario ya puede entrar en Necada:

Un usuario Results Viewer recien creado no está asignado a ningún proyecto. Si hace login, sólo podrá ver el contenido público (y eso lo podría ver aunque no hiciera login). Para que pueda ver los experimentos es necesario darle permisos.

Para ello, desde la lista de usuarios, se clica el botón Assignations y se muestra este formulario:

Si miramos las columnas, la primera muestra el primer proyecto, BIM Validation Reports, que es un proyecto que crea Necada para validar cada fichero IDF que se sube al sistema. Se puede asignar un usuario Results Viewer a este proyecto, pero no tiene ninguna utilidad.

El resto de columnas son los proyectos que ha creado el usuario. En nuestro ejemplo sólo hay un proyecto creado, My First Project.

Si miramos las filas, tenemos una fila por cada usuario Results Viewer que haya creado el usuario. En nuestro caso sólo hay un usuario, ResultsViewer1.

Si clicamos en el segundo recuadro, asignaremos el usuario ResultsViewer1 con el proyecto My First Project:

Si clicamos en el segundo recuadro, asignaremos el usuario ResultsViewer1 con el proyecto My First Project.

Para que se guarden los cambios hay que clicar en el botón Assign users to Projects

Ahora el usuario ResultsViewer1 puede ver todos los experimentos del proyecto My First Project.

Aquí finaliza el tutorial.



Geting started old

This section describes the basic elements needed on order to execute an experiment in NECADA infraestructure.

Introduction

TODO...

Account Registration; Account Settings; Passwords

You could explore the public data in the dashboard or you could

Feel free to send us an email and we will contact you to analyze your project and provide you the needed acces to the platform.

Preparing the model

The model, based on BIM paradigm, must be prepared following the IDF format, see our public library.

Once the model is prepared on your preferred tool, you can upload it to NECADA platform to start the exprimentation.

Some of the tools you can use to define an IDF model are: Note that this is not in any sense an extensive list and only is representing an example of the current tools.

Executing the model

TODO...

Additional actions

TODO...




Modelling

TODO...

Building models

TODO...

Materials

TODO...

Construction solutions

TODO...

Climate data

TODO...

Sustainability indicators

TODO...




Price policy

This price notice applies to the use of NECADA service.

Prices

TODO...

Working in your presises

TODO...