Report Generation. Name: Path: Keywords:

Transcription

1 Report Generation Name: Path: Keywords: ReportGeneration/repgen /Examples//ReportGeneration/repgen analys: eigen geomet nonlin physic. constr: suppor. elemen: beam class2 curved interf l13be q20sh q24if t15sh t18if rectan shell struct. load: weight base. materi: coulom dampin elasti engmas fricti isotro orthot viscou. option: direct lagran newton nonsym regula total units. result: cauchy crack crkwdt displa eigen force green princi reacti strain stress total tracti values.

2 Outline 1 Introduction and report overview 2 Description of model and performed analyses 3 Highlights of the report generation tool 4 Report settings 4.1 Chapter 1 - Introduction 4.2 Chapter 2 - Project details 4.3 Chapter 3 - Model characteristics 4.4 Chapter 4 - Materials 4.5 Chapter 5 - Geometries 4.6 Chapter 6 - Supports and loads 4.7 Chapter 7 - Analysis settings 4.8 Chapter 8 - Results 5 Generate and Save the Report 5.1 Report file Report Generation 2/48

3 1 Introduction and report overview This example illustrates the main features and possibilities offered by DIANA for the generation of a project report. The report will include the main characteristics of the model and all the relevant information concerning element geometries, material properties and loading conditions. The tutorial will demonstrate how different results obtained from the analysis can be included in the report and how to automatically generate and export the report using the functionalities of the DIANA Interactive Environment. Figure 1: Overview of front page of DIANA Report in Word and HTML formats Report Generation 3/48

4 2 Description of model and performed analyses The model considered in the present tutorial represents a simple masonry building. This building was previously described in the DIANA tutorial Pushover Analysis of a Masonry House. The geometry and mesh of the model are shown in [Fig. 2] - [Fig. 3]. A nonlinear time-history analysis will be performed using an acceleration signal applied at the base of the model in order to determine the response of the structure when subjected to seismic loading. For the scope of the example and in order to keep a reduced calculation time, the analysis is performed up to 1 second of the imposed time-history. The set-up of the analysis commands for the nonlinear time-history are not reported in the presentation but can be found in the respective Python file. This tutorial will focus only on the generation of the project report. Figure 2: Geometry of the masonry house Figure 3: Mesh of the model Report Generation 4/48

5 3 Highlights of the report generation tool The main features of the report generation available in DIANA will be presented in this tutorial. The focus is placed on the following points: Use of customized templates; Description of model geometry, mesh and input; Description of the analysis commands; Results presentation possibilities: Use of own result view settings for each result image; Probing curves for results along a reference line; Clipping planes for sliced view results; Report Generation 5/48

6 4 Report settings 4.1 Chapter 1 - Introduction We create a new report block and we rename it as Simple Masonry House Report [Fig. 4]. We add the first chapter of the report and we rename it as Introduction [Fig. 5]. Main Menu Report Add report [Fig. 4] Report browser Report repgen 1 Rename Simple Masonry House Report [Fig. 4] Main Menu Report Create a chapter [Fig. 5] Report browser Chapter 1 Rename Introduction [Fig. 5] Figure 4: New Report Figure 5: Chapter 1 Report Generation 6/48

7 We add first a Text report section to Chapter 1 [Fig. 6] and input a short description of its content [Fig. 7]. Main Menu Report Add report section Text [Fig. 6] Figure 6: Chapter 1 tree Figure 7: Text section Note that, in the text fields of the report, the use of Markdown syntax can be effectively employed to obtain formatted text. Some examples of Markdown possibilities and the corresponding formatted text appearing in the generated report are listed in the following: Report Generation 7/48

8 We can add an External image to Chapter 1 [Fig. 8]. In the property window we can input the image path and position within the report [Fig. 9]. Main Menu Report Add report section External image [Fig. 8] Figure 8: Chapter 1 tree Figure 9: External image Report Generation 8/48

9 We now add the Document properties to Chapter 1 [Fig. 10]. We can fill in all the required information to be included in the document (such as report title, author, etc.) [Fig. 11]. Main Menu Report Add report section Document properties [Fig. 10] Figure 10: Chapter 1 tree Figure 11: Document properties Report Generation 9/48

10 Afterwards, we also add the Project information section to the same chapter [Fig. 12]. In order to obtain a preliminary view of the information added into the report, we can Run the report and make use of the Preview report tool. A preview of the section is shown in [Fig. 13]. Main Menu Report Add report section Project information [Fig. 12] Main Menu Report Run report Report browser Report preview [Fig. 13] Figure 12: Chapter 1 tree Figure 13: Project information preview Report Generation 10/48

11 Finally in Chapter 1 we add the Geometry dimensions section [Fig. 14]. This section reports the overall dimensions of the model, based on the maximum and minumum coordinates of its geometry. A preview of this section is shown in [Fig. 15]. Main Menu Report Add report section Geometry dimensions [Fig. 14] Main Menu Report Run report Report browser Report preview [Fig. 15] Figure 14: Chapter 1 tree Figure 15: Geometry dimensions preview Report Generation 11/48

12 4.2 Chapter 2 - Project details We add the second chapter of the report and rename it as Project details [Fig. 16]. We also set the reference units to be used within the report [Fig. 17]. Main Menu Report Create a chapter [Fig. 16] Report browser Chapter 2 Rename Project details [Fig. 16] Model Window Reference system Units Property panel [Fig. 17] Figure 16: Chapter 2 tree Figure 17: Units Report Generation 12/48

13 We firstly add the Reference Units section to the chapter [Fig. 18], and we show a preview of the table included in the report [Fig. 19]. Main Menu Report Add report section Reference Units [Fig. 18] Main Menu Report Run report Report browser Report preview [Fig. 19] Figure 18: Chapter 2 tree Figure 19: Units section preview Report Generation 13/48

14 We add the Reference Direction section [Fig. 20], which includes a table defining the coordinates of the reference system axes. A preview of this table is shown in [Fig. 21]. Main Menu Report Add report section Reference Directions [Fig. 20] Main Menu Report Run report Report browser Report preview [Fig. 21] Figure 20: Chapter 2 tree Figure 21: Reference directions section preview Report Generation 14/48

15 We finally add the Reference Definition section [Fig. 22], as shown in the preview table in [Fig. 23]. Main Menu Report Add report section Reference Definitions [Fig. 22] Main Menu Report Run report Report browser Report preview [Fig. 23] Figure 22: Chapter 2 tree Figure 23: Reference definition section preview Report Generation 15/48

16 4.3 Chapter 3 - Model characteristics We add the third chapter of the report and rename it as Model characteristics [Fig. 24]. This chapter will contain information regarding the geometry and mesh and also include some figures of the model. Main Menu Report Create a chapter [Fig. 24] Report browser Chapter 3 Rename Model characteristics [Fig. 24] Figure 24: Chapter 3 tree Report Generation 16/48

17 We add the Geometry view section to the chapter. We show the geometry of the model in isometric view. By right-clicking in the working area we can directly add the Geometry view section to the report [Fig. 25]. We insert the caption text for the figure in the properties panel [Fig. 26]. Extra information can be added via the checkboxes (Show Loads, Supports or Interfaces). Main menu Viewer View points Isometric view 1 Main menu Viewer Fit all Working window Insert geometry view section [Fig. 25] Figure 25: Geometry view Figure 26: Figure properties Report Generation 17/48

18 We also add the Geometry shapes section to the chapter [Fig. 27]. By using the Report preview it is possible to see the content of the geometry tables, as shown in [Fig. 28]. Main Menu Report Add report section Geometry shapes [Fig. 27] Main Menu Report Run report Report browser Report preview [Fig. 28] Figure 27: Chapter 3 tree Figure 28: Geometry shapes table preview Report Generation 18/48

19 We add the Mesh view section to the chapter. We show the mesh in isometric view. By right-clicking in the working area we can directly add the Mesh view section to the report [Fig. 29]. In the properties panel we insert the caption text for the figure and we ask to show the supports on the mesh view [Fig. 30]. Main menu Viewer View points Isometric view 1 Main menu Viewer Fit all Working window Insert mesh view section [Fig. 29] Figure 29: Mesh view Figure 30: Figure properties Report Generation 19/48

20 We also add the Mesh sets section to the chapter [Fig. 31]. This section includes a table with the different sets of the mesh, and with number of elements, material, geometry and data for each set [Fig. 32]. Main Menu Report Add report section Mesh sets [Fig. 31] Figure 31: Chapter 3 tree Figure 32: Mesh sets table preview Report Generation 20/48

21 4.4 Chapter 4 - Materials We add the fourth chapter containing the material properties and we rename it as Materials [Fig. 33]. For each material defined in the model we add a Material information section to the report. This can be directly done by right-clicking on the material name from the material list and choosing Insert material into report [Fig. 34]. Main Menu Report Create a chapter [Fig. 33] Report browser Chapter 4 Rename Materials [Fig. 33] Geometry browser Materials clay bricks Insert material into report [Fig. 34] Figure 33: Chapter 4 tree Figure 34: Insert material section Report Generation 21/48

22 A table with the mechanical properties will be automatically created for each material and included in the report file. As an example, a preview of the tables generated for the clay bricks, timber and friction, respectively assigned to the masonry, timber beams and interface elements, are reported respectively in [Fig. 35], [Fig. 36] and [Fig. 37]. Figure 35: Masonry material Figure 36: Timber material Figure 37: Interface material Report Generation 22/48

23 4.5 Chapter 5 - Geometries We add the fifth chapter containing the element geometry properties and we rename it as Geometries [Fig. 38]. For each geometry property defined in the model we add an Element geometry information section to the report. This can be directly done by right-clicking on the geometry name from the element geometry list an choosing Insert element geometry into report [Fig. 39]. Main Menu Report Create a chapter [Fig. 38] Report browser Chapter 5 Rename Geometries [Fig. 38] Geometry browser Element geometries founda shl Insert element geometry into report [Fig. 39] Figure 38: Chapter 5 tree Figure 39: Insert element geometry section Report Generation 23/48

24 For each element geometry defined in the model, a table with the typology and assigned parameters is generated and included in the report. Some examples showing the tables for the geometry properties assigned to the masonry walls and to the timber beams are reported respectively in [Fig. 40] and [Fig. 41]. Figure 40: Element geometries for masonry walls Figure 41: Element geometry for timber beams Report Generation 24/48

25 4.6 Chapter 6 - Supports and loads We add the sixth chapter of the report and rename it as Supports and loads. We add the Geometry support sets section in this chapter [Fig. 42]. This section contains a table for each support set defined within the model geometry. In this case, only base support have been assigned to the structure, as shown in the preview table [Fig. 43]. See also the mesh view reported in slide 19 in which the base support set is shown. Main Menu Report Create a chapter [Fig. 42] Report browser Chapter 6 Rename Supports and loads [Fig. 42] Main Menu Report Add report section Geometry support sets [Fig. 42] Figure 42: Chapter 6 tree Figure 43: Support sets preview Report Generation 25/48

26 We also add the Geometry load cases section to the chapter [Fig. 44]. The preview shown in [Fig. 45] reports the tables with the information from each load case defined in the model. Main Menu Report Add report section Geometry load cases [Fig. 44] Figure 44: Chapter 6 tree Figure 45: Load sets preview Report Generation 26/48

27 As an example, for one of the load cases reported in the previous table, we also include the corresponding time loading chart. Therefore we add a Geometry load case section [Fig. 46] to the report. We can do this directly by right-clicking on the base acceleration load ACC X in the global X direction from the Loads list in the Geometry browser [Fig. 47]. Geometry browser Loads ACC X Insert geometric load case into report [Fig. 47] Figure 46: Chapter 6 tree Figure 47: Insert load case section Report Generation 27/48

28 We are only interested in adding the plot of the load factors versus time associated to the ACC X load case. Therefore, in the properties panel we select only Add time dependency chart and we deselect all the other items [Fig. 48]. By using the report preview it is possible to see the aspect of the Time dependency chart [Fig. 49]. Main Menu Report Run report Report browser Report preview [Fig. 49] Figure 48: Property panel for Geometry load case Figure 49: Preview of time dependency chart Report Generation 28/48

29 4.7 Chapter 7 - Analysis settings We add the seventh chapter of the report and rename it as Analysis settings. This chapter will contain settings defined for each analysis block. Main Menu Report Create a chapter [Fig. 50] Report browser Chapter 7 Rename Analysis settings [Fig. 50] Figure 50: Chapter 7 tree Report Generation 29/48

30 A preliminary eigenvalue analysis (EV ) is performed in order to evaluate the vibration modes of the building. A total number of 10 eigenvalues are asked and the calculation is based on the Implicitly restarted Arnoldi solution method. The first Analysis section included in the report contains the settings for the Structural Eigenvalue analysis [Fig. 51]. In the corresponding properties panel we insert the analysis name EV and we ask to add the analysis set-up definitions and to include the content of the DCF file in the report [Fig. 52]. Main Menu Report Add report section Analysis [Fig. 51] Figure 51: Chapter 7 tree Figure 52: EV analysis section properties Report Generation 30/48

31 The building is submitted to a nonlinear time-history analysis (NLTH ), performed considering physical and geometrical nonlinear effects. In the analysis, the static load due to the self-weight is applied first. Afterwards, the dynamic loading, represented by three base accelerations, is applied with a time step of seconds at a total of 600 steps. The chosen iteration procedure is based on the Quasi-Newton method with a maximum number of 20 iterations. The convergence criterion chosen is based on energy norm with default settings. In this example we set a total stop time at 1 second in order to reduce the computation time. Therefore, we include a second Analysis section in the report for the nonlinear time-history analysis [Fig. 53]. In the corresponding properties panel we insert the analysis name NLTH and we ask to add the analysis set-up definitions and to include the content of the DCF file in the report [Fig. 54]. Main Menu Report Add report section Analysis [Fig. 53] Figure 53: Chapter 7 tree Figure 54: NLTH analysis section properties Report Generation 31/48

32 In the report preview it is possible to visualize the definition of the analysis settings. As an example, the settings for the eigenvalue analysis included in the report are shown in [Fig. 55]. In the property panel [Fig. 52] - [Fig. 54], the default number of 5 has been kept for the depth of the command description three. Through this parameter it is possible to influence the level of detail used in the description of the analysis settings. The command file content is shown in [Fig. 56]. Figure 55: EV analysis definition Figure 56: DCF contents for the EV analysis Report Generation 32/48

33 4.8 Chapter 8 - Results We add the eighth chapter of the report and rename it as Results [Fig. 57]. Main Menu Report Create a chapter [Fig. 57] Report browser Chapter 8 Rename Results [Fig. 57] Figure 57: Chapter 8 tree Report Generation 33/48

34 For the first Result image section of chapter 8, we will apply the View setting defined in the View settings window [Fig. 58]. Here we will use the default Contour plot settings and we will disable the use of Clip planes and Probing curves [Fig. 59]. In addition, we will define the preferred Legend appearance settings, such as legend size, label precision and font size to be used in the result images [Fig. 60]. View settings toolbar Edit view settings View setting Apply view setting [Fig. 58] Properties Contour plot settings Clip settings Enable OFF [Fig. 59] Properties Probing curve settings Enable curves OFF [Fig. 59] Properties Legend appearance Size <0.02, 0.9 > [Fig. 60] Properties Legend appearance Label precision <1 > [Fig. 60] Properties Legend appearance Font Size <21 > [Fig. 60] Figure 58: View settings window Figure 59: Properties window Figure 60: Legend appearance settings Report Generation 34/48

35 We add now the Result image section for the maximum positive displacements registered on the building. We can first choose the most appropriate view settings for the model and afterwards show the required result in the working window. We can then directly insert the result view in the report by right-clicking in the working window as shown in [Fig. 61]. In the properties panel we insert the caption text for the figure [Fig. 62]. Result browser Analysis NLTH Result browser Case Extreme maximum up to Time-step 202 Result browser Output max Nodal results Total displacements TrDtXYZ Working window Insert result view section [Fig. 61] Figure 61: Maximum relative displacements TrDtXYZ Figure 62: Image result section properties Report Generation 35/48

36 For the same result, we show how different settings can be used for the contour plot image. Therefore, we duplicate the first View setting [Fig. 63]. Within the new viewsetting 5, as an example, we will set the maximum value for the color scale limit corresponding to a displacement of 10 mm and we will divide the color scale into 5 contour levels [Fig. 64]. View settings toolbar Edit view settings View setting Duplicate view setting [Fig. 63] View settings toolbar Edit view settings viewsetting 5 Apply view setting [Fig. 63] Properties Contour plot settings Color scale limits Specified values [Fig. 64] Properties Contour plot settings Specified values Maximum value <10 > [Fig. 64] Properties Contour plot settings Discrete color scale options Number of contour levels <5 > [Fig. 64] Figure 63: New view setting Figure 64: Contour plot settings Report Generation 36/48

37 We can now show in the working window the extreme maximum displacements over the building for the last step of the analysis and add the result image to the report [Fig. 65]. Result browser Analysis NLTH Result browser Case Extreme maximum up to Time-step 202 Result browser Output max Nodal results Total displacements TrDtXYZ Working window Insert result view section [Fig. 65] Figure 65: Maximum relative displacements TrDtXYZ Figure 66: Image result section properties Report Generation 37/48

38 In the following slides we will set up a probe curve for the displacements on top of the building and we will show how to add this result to the report. We fist create the viewsetting 6 by duplicating the first View setting [Fig. 67]. In the properties window of the new view setting, we first enable the use of probing curves [Fig. 68]. Afterwards, we can set the scale factor and the orientation of the diagram [Fig. 68]. View settings toolbar Edit view settings View setting Duplicate view setting [Fig. 67] View settings toolbar Edit view settings viewsetting 6 Apply view setting [Fig. 67] Properties Probing curve settings Enable curves ON [Fig. 68] Properties Probing curve settings Scale factor <10 > [Fig. 68] Properties Probing curve settings Diagram orientation <Orient by global X axis> [Fig. 68] Figure 67: New view setting Figure 68: Probing curve settings Report Generation 38/48

39 We can now add a new probing curve [Fig. 69]. After adding the curve, we choose the number of intervals into which it will be divided and we add the point coordinates [Fig. 70]. Properties Probing curve settings Curve [Fig. 69] Properties Probing curve settings probe-curve Number of intervals between points <50 > [Fig. 70] Properties Probing curve settings probe-curve Point coordinates [Fig. 70] Figure 69: Add new probe curve Figure 70: Add point coordinates Report Generation 39/48

40 We input the coordinates of the two extreme points of the probing curve [Fig. 71]. We choose the two corners on top of the building represented in the mesh view reported in [Fig. 72]. Properties Probing curve settings probe-curve Point coordinates <(3150, 50, 3000) mm; (3150, 5150, 3000) mm> [Fig. 71] Figure 71: Point coordinates input Figure 72: Extreme points for probing curve definition Report Generation 40/48

41 We now show the extreme maximum displacements in the X direction for the last step of the analysis and we add the result image with the probing curve into the report by right clicking into the working window [Fig. 73]. We choose a convenient orientation by rotating the model in the working window and we plot the results on the undeformed shape of the building. Main menu Results Normalized deformed results OFF Result browser Analysis NLTH Result browser Case Extreme maximum up to Time-step 202 Result browser Output max Nodal results Total displacements TrDtX Working window Insert result view section [Fig. 73] Figure 73: Maximum relative displacements TrDtX Figure 74: Image result section properties Report Generation 41/48

42 In the following slides we show how to define a clipping plane and add the relative result image to the report. We create the viewsetting 7 by duplicating the first View setting [Fig. 75]. In the properties window of the new view setting, we first enable the use of clipping planes [Fig. 76]. We can now add a new plane [Fig. 76] and define the coordinates for its location and normal direction, respectively [Fig. 77]. View settings toolbar Edit view settings View setting Duplicate view setting [Fig. 75] View settings toolbar Edit view settings viewsetting 7 Apply view setting [Fig. 75] Properties Contour plot settings Enable ON [Fig. 76] Properties Contour plot settings Clip settings plane [Fig. 76] Properties Contour plot settings Clip settings plane Location <(0, 2500, 0) mm> [Fig. 77] Properties Contour plot settings Clip settings plane Normal <(0, 1, 0) mm> [Fig. 77] Figure 75: View setting window Figure 76: Add new plane Figure 77: Properties window Report Generation 42/48

43 We can now add the clipped contour plot view to th report by right clicking into the working window [Fig. 78]. We keep the undeformed shape of the building and we choose the isometric view of the model. Main menu Viewer View points Isometric view 1 Main menu Viewer Fit all Working window Insert result view section [Fig. 79] Figure 78: Maximum relative displacements TrDtX Figure 79: Image result section properties Report Generation 43/48

44 We add the Graph result section for the displacement history of a top node of the model. We first select the node at the coordinates (3.2, 2.6, 3) m [Fig. 80] and then we choose Insert node result chart section from the right-click menu after showing the Total displacements over the model in the working window [Fig. 81]. Model Nodal selection <Select the node located at (3.2, 2.6, 3) m> [Fig. 80] Result browser Analysis NLTH Result browser Case Time-step 202, Time Result browser Output current Nodal results Total displacements TrDtX Working window Insert node result chart section [Fig. 81] Figure 80: Selected node for displacements Figure 81: Insert node chart results section Report Generation 44/48

45 The plot of the displacement history of the selected point can be checked using the report preview function, as shown in [Fig. 83]. Figure 82: Chapter 8 tree Figure 83: Preview of the top node displacement plot Report Generation 45/48

46 5 Generate and Save the Report We can run the automatic generation of the final document and save it in the most suitable format. The preview function of the built report allows for a quick check of the content. Several formats are available, as shown in [Fig. 84]. In this case we choose for a report in html format [Fig. 85]. Main Menu Report Run report Main Menu Report Preview report Main Menu Report Save report [Fig. 84] [Fig. 85] Figure 84: Choice of report format Figure 85: Save report in html format Report Generation 46/48

47 5.1 Report file The generated report contains a list of topics (Table of contents in the exported file) and includes all the information regarding the geometry of the model, the mesh characteristics, the properties (materials, geometries, boundary and loading conditions), analysis settings and results. The following figures show some portions of the report file with significant data and results. As an example, [Fig. 86] shows the introductory part, while [Fig. 87] shows the report section with maximum and minimum displacements over the structure and the displacement history of a point at the roof level. Figure 86: Report introduction Figure 87: Results included in the report Report Generation 47/48

48 DIANAFEA.COM DIANA FEA BV Delftechpark 19a 2628 XJ Delft The Netherlands T +31 (0) F +31 (0) DIANA FEA BV Vlamoven TN Arnhem The Netherlands T +31 (0) F +31 (0) TNO DIANA North America Inc N. Laurel Park Dr. Suite 205 Livona MI United States T +1 (0)