With the Ceetron Report Component, 3D content can easily be included in MS Office documents. The engineer can explore the model and the results in full 3D, providing increased understanding and more data readily available. Including 3D content in the report reduces the need for multiple images and videos, adding flexibility and the ability to answer ad-hoc questions. The Ceetron Report Component collects and organizes all data in one place, and creates reports in MS Word, MS PowerPoint and HTML from the same source. It can even produce Word/PowerPoint reports on Linux.
The Report component uses the Ceetron VTFx format and the Ceetron 3D Plugin to embed the 3D model directly into the Word document or the PowerPoint presentation. The Ceetron 3D Plugin for Microsoft Office is our plugin to the Microsoft Office suite, which enables interactive 3D models with animation embedded into the PowerPoint presentation or Word document. For a HTML report, the 3D model is rendered directly into the web browser using Ceetron Cloud.
The main building block of the Report component is a Snapshot. A snapshot is a capture of information from your application at a given setup. A snapshot contains either an image (for instance a snapshot of the view), a 3D model with results and feature extractions, a 2D plot/graph or a tabular result listing. Each snapshot also has a title, a description and a set of field values. A collection of snapshots are stored in a Repository.
A creator produces a report based on a repository and a template file. There are creators for Word, PowerPoint and for HTML. The creator checks for tagged objects in the template document/presentation and replaces this with snapshot data found in the repository when creating the report document/presentation.
The simple concept behind the Report component is that templates are created using ordinary Word/PowerPoint/HTML documents. Insert dummy data and tag these with a snapshot type and a snapshot index. Create a repository of snapshots matching the template. Feed both repository and template file to a creator, and it will produce a report for you with all the dummy objects replaced with actual data from your simulation. Easy to create, easy to share.
In the screenshots below, you can see very simple Word and PowerPoint templates with the tagged objects showing. (Please note that these tag names are invisible for normal view and usage and is only shown when you open the 'Selection and Visibility' pane in PowerPoint or toggle the 'Design Mode' button in Word.) All tags can be set using native Word/PowerPoint, but to simplify the template creation, Ceetron provides a Report Addin for Microsoft Office.
Read more about creating your own templates and the Report Addin in the topic: Creating a template for Ceetron Report
The naming scheme for tags are the same for all report types. See more information on this in the topic: Ceetron Report: Tag behavior and syntax.
A repository consists of one or more snapshots. Each snapshot contains a title, a description, field values and a media object (image, VTFx model or tabular data).
Read more about snapshot types at: Ceetron Report: Snapshots
First, create the Repository object:
Example on creating and adding an image snapshot:
Example on creating and adding a table snapshot: (In this example, we're getting the name, mapping type and minimum/maximum scalar values from the currently showing scalar result.)
Example on creating and add a VTFx snapshot:
The report is created based on a repository of snapshots and a template file (which is an ordinary MSOffice file/HTML file containing tags for the Report component to interpret.)
See Creating a template for Ceetron Report
Create a creator and let it produce your report:
This figure shows a simple template presentation containing three slides, one with an image, one with a table and one with a plugin. And below is the resulting report presentation based on the repository created in the examples above:
For more code examples, please check the example applications includes in the distribution under the "Examples\" folder.
![]() | Location: Examples/Qt/QtReport The QtReport example creates reports using the model in the view and simple included templates. This example describes creating all three snapshots types (image, VTFx, and table) for Word, PowerPoint and HTML. It also shows how to use generic snapshot tags and field values. |
![]() | Location: Examples/WinForms/WinFormsReport The WinFormsReport example creates reports using the model in the view and simple included templates. This example describes creating all three snapshots types (image, VTFx, and table) for Word, PowerPoint and HTML. It also shows how to use generic snapshot tags and field values. The WinForms example also shows how to integrate your reports directly to Ceetron Cloud. |
![]() | Location: Examples/Qt/QtRepositoryManager In addition, there's a QtRepositoryManager example which is a simple manager for a repository file. This allows you to open a repository file and view the actual snapshot content. (There is an example repository in the "Examples/ReportTemplates" folder in the distribution.) You can add individual snapshots and save the new repository. The QtRepositoryManager example lets you select your own template file (or use one of the predefined found in the Examples/ReportTemplates folder). The QtRepositoryManager example also allows you to integrate your reports directly to Ceetron Cloud. |
![]() | Report: Create a Word report with a 3D model Shows how to create a Word report where the 3D model from your view is inserted (and embedded) into the Word document along with some metadata. |