Viewpoint Modeling and Model-Based Media Generation for Systems Engineers Automatic View and Document Generation for Scalable Model- Based Engineering Christopher Delp NASA/Caltech Jet Propulsion Laboratory Chair: SysML 1.4 RTF Auto-View Generation Working Group

Useful Links Auto-View Generation Working Group – autoview:auto-view_generation_working_group

Outline Auto-View Working Group Background First Phase of Effort Plan Forward Summary

AUTO-VIEW GENRATION WORKING GROUP Purpose and Objectives

Purpose of Presentation Review and obtain feedback on preliminary AVGWG work products – Concepts – Requirements – Use cases Describe issues Next steps – Evaluate and propose solutions

Auto-View Working Group Need: – Capability to generate views of the modeling information based on specified viewpoints. These views may include presentation of the information in multiple formats such as diagrams, tables, and entire documents. Goals: – Establish a standardized approach for generating views from the models leveraging current practices where practical. The intent is to enable SysML tool vendors to support view generation in a more standard way. Objectives: – Define the changes needed to SysML to enable automated document and view generation from a SysML model and related external artifacts based primarily on refinements to the view and viewpoint concepts in SysML. Note: this work group began as part of the SysML 1.4 Revision Task Force (RTF), but this site is being maintained under the OMG SysML™ Project Portal. This enables additional participants, and also provides visibility to activities outside the scope of this RTF.

Scope Identify requirements Potential solutions Identify changes within the scope of the SysML v1.4 RTF Identify changes that are out of scope of the SysML v1.4 RTF. – identify broader stakeholder participation to develop a roadmap on how to move forward with the changes outside of this RTF.

Deliverables Issue identification 4 issues identified Requirements Set of draft requirements documented Summary of current solutions refer to SE DSIG on June 19, 2012 as a starting point and add as required  Proposed solution to the above issue  should include actual specification changes including new stereotypes, model libraries, and examples  Prototype application of this solution  auto-generate the SysML v1.4 specification

BACKGROUND Document generation across industry

Background At the SE DSIG meeting on June 18, 2012 in Cambridge, several individuals presented and demonstrated practices for view generation from the model that are now in common use. Refer to the meeting minutes and presentations in the Cambridge SE DSIG meeting page. This working group was formed as a follow-up action from this meeting.Cambridge SE DSIG meeting page.

Auto-View Generation Approaches Across Industry ESO MBDG Open Source Docgen JPL MBEE (Docgen, Docweb, View Editor, System Database) Lockheed Martin DocGen Atos Gendoc

Common Features Across Industry A need to communicate with stakeholders – According to terms of the stakeholders Variety of representations Edit the Model Information through multiple UI Enterprise integration of multiple applications and modeling tools

CONCEPTS REQUIREMENTS AND USECASES First Phase of Effort

Communication as a Principle Communicating through understanding point of view – Understanding the Point of View of Stakeholders Concerns – Describing the model from that Point of View Identifying parts of the model that address concerns – Telling the story of the Views Linearization of the Views of the Model

Engineer “The glass is twice as big as it needs to be”

View and Viewpoint Update 3/2/13

Generating Reports from Models Document Generator 17 Model, Viewpoints and View Models Reports output using styles and formats specified in the method Model Repository Document Repository Model Editing Tool Web –based Model Editors Model transformation from SysML to Documents (HTML, PDF etc)

Types of Requirements Analysis Architecture Framework Extensibility Configuration Management Conformance Diagram Views Dynamic Views Editability Executable Independence Inclusion Interoperability Method Separation of Models Styles Tool Independence Viewpoint Model

Use Cases

EXAMPLE USECASES

Lockheed Example Usecase

Features & Capabilities Recursive Document Structure Modeling – Define the recursive document structure – Define the loop using «startLoop» and «closeLoop» dependencies – Define the data sets used in this structure – Reference the data sets using «referenceTo»

Features & Capabilities Scope Query

Document Preview and Validation Document Preview Document Preview Component Preview Component Preview View the list of ≪ dataReference ≫ objects and their data Extract valid property names to Excel spreadsheet Create a file to schedule an autorun Validation Logs

ESO Example Usecase

JPL Example Usecase

Building the Viewpoint Model Viewpoint Model – Purpose informed by Stakeholder Concerns – Methods and Analysis for constructing the View from the Model – Presentation Rules

Method and Analysis Methods – Ordered steps for producing the View Analysis – describe the nature of queries of the model – Analytical assertions – Rules for completeness and consistency Format and Presentation Style – Describe the conventions styles and formats for how the information is presented in the View

Viewpoint and View

Views of Models

Simple Spacecraft Diagram Views Spacecraft SysML IBD Star Tracker Behavior Scenario Spacecraft Star tracker Behavior

Linearizing the Views Model of Views – Story of Views – Outline of Views – Template Outline of Viewpoints “Template” Outline of Viewpoints 2 Model Outlines of Views based on the same Viewpoint Template

Libraries Viewpoints – Collections of standard representations Methods – Reusable methods for producing different models and representations used in Views Analyses – Libraries of model analyses, queries and rules for checking models Presentation Styles – Styles for presenting models and data such as colors, layout schemes, and conventions Format – Models for formatting information such as Docbook, Office Schemas and modeling languages

ISSUES View Modeling

View and Viewpoint Limitations Issue Viewpoint method limitations Viewpoint description limitations View import limitations Other view construction limitations

View and Viewpoint Issues

Model Issues

PLAN FORWARD

Plan Forward Form and Scope Working Group Define Requirements Define Usecases Articulate issues  Propose Solutions

SUMMARY

Summary Critical capability for industry Synthesized Industry Innovation Concept Requirements Usecases Submitted 1.4 RTF Issues  Working Solutions

BACKUP

Information Rendered According to Viewpoints Domain Specific Modeling Applications Document and Report Generation Web Editable View Apps CAD (Mechanical, Electrical etc) Software Design (UML etc) MBSE (SysML etc) Analysis (Analytic, Simulation, spreadsheet) Production Models Viewpoints and Domain Specific Languages Model Repository Viewpoints For Domain specific Apps Web- editable Viewpoints Final products rendered according to Viewpoints and Models