Documentación del modelo

Unos de los pasos a tener en consideración a la hora de hacer un modelo de simulación es la documentación de lo que se esta realizando, este paso es muchas veces pasado por alto y es crucial a fin de darle continuidad  y la transferencia de conocimientos de una generación a otra. Comenzar a trabajar en un modelo que no esta documentado puede ser frustrante para los nuevos usuarios. Unos pasos a considerar para la documentación de un modelo son:

 

a)    Haga una estrategia para la estructura y forma del modelo. Antes de que el modelo sea construido la estructura general debería ser considerada. Esta conceptualizacion incluye cuantas partes debería tener el modelo y relacionar cada una de las partes.

 

b)    Nombres convencionales. cada uno de las partes (libros y hojas de trabajo) debería tener un nombre propio. el enfoque recomendado es simplemente proveer un nombre descriptivo para cada parte del modelo. si el modelo requiere múltiples iteraciones, especialmente cuando el modelo es creado por varias personas a través del tiempo, la fecha y versión debería ser parte del nombre propuesto para el archivo del modelo,

 

c)    Resumen primario. En la primera sección del modelo siempre debe haber una pagina de bienvenida con una resumen primario del modelo. el resumen puede incluir el nombre del archivo, localización de las unidades compartidas, versión del modelo, desarrolladores, y otras información que se crea pertinente colocar, incluyendo instrucciones, hipótesis, advertencias, avisos o sugerencias sobre el uso del modelo

 

 

d)    Propiedades del archivo. Hacer pleno uso de las propiedades de los archivos. esta simple acción marca la diferencia entre un modelo "huérfano" y un modelo que los usuarios tendrán mas confianza en el modelo.

 

e)    Cambios del documento y ajustes. Si hay varios desarrolladores trabajando en el modelo, cuando el modelo se guarda, los cambios, ajustes, cambios, y modificaciones siempre debe estar documentado de tal manera que cualquier acción en el pasado se pueda deshacer en caso de que fuera necesario. Esta simple práctica también proporciona un método para realizar un seguimiento de los cambios que se han hecho frente a una lista de los errores o las necesidades de desarrollo.

 

 

f)      Ilustrar formulas. Considere la posibilidad de ilustrar y documentar las fórmulas utilizados en el modelo, especialmente cuando las ecuaciones y cálculos complicados son requeridas.

 

g)    Interpretación de resultados. En el resumen primario, en los informes o la pagina de resumen de resultados, se deben incluir las instrucciones de como resultados analíticos finales pueden ser interpretados, incluyendo que hipótesis fueron usadas cuando se construyo el modelo, etc.

 

h)    Estructura de presentación de informes. Un buen modelo debería tener un informe final después que los datos de entradas hayan sido colocados en el modelo y se realiza el análisis. la simplicidad del informe va a depender de la cantidad de información que se coloque.

 

 

El modelo necesita ser estrategizado y tener un adecuado nombre, un resumen primario, incluir las descripciones de las propiedades del modelo, indicar los cambios y ajustes hechos, ilustrar las formulas, documentar como interpretar los resultados, proveer una estructura de reporte, y hacer seguro el modelo y fácil de maneja.

 

Tomado del libro “Modeling Risk” de Johnathan Mun. Wiley Finances (2006)

Entradas populares de este blog

Simulación Geoestadística: Métodos del tipo Gaussiano

Puente de material

LOWIS™ Life of Well Information Software