1. 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

2. Useful Links Auto-View Generation Working Group – http://www.omgwiki.org/OMGSysML/doku.php?id=sysml- autoview:auto-view_generation_working_group

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

4. AUTO-VIEW GENRATION WORKING GROUP Purpose and Objectives

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

6. 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.

7. 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.

8. 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

9. BACKGROUND Document generation across industry

10. 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.

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

12. 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

13. CONCEPTS REQUIREMENTS AND USECASES First Phase of Effort

14. 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

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

16. View and Viewpoint Update 3/2/13

17. 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)

18. 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

19. Use Cases

20. EXAMPLE USECASES

21. Lockheed Example Usecase

22. 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»

23. Features & Capabilities Scope Query

24. 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

25. ESO Example Usecase

28. JPL Example Usecase

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

30. 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

31. Viewpoint and View

32. Views of Models

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

34. 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

35. 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

36. ISSUES View Modeling

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

38. View and Viewpoint Issues

39. Model Issues

40. PLAN FORWARD

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

42. SUMMARY

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

44. BACKUP

45. 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