GITBOOK-88: No subject

BlockResearchGroup · Oct 3, 2024 · df3db25 · df3db25
1 parent 0f7a431
commit df3db25
Show file tree

Hide file tree

Showing 43 changed files with 459 additions and 0 deletions.
diff --git a/gitbook/.gitbook/assets/armadillo-blocks_viewer.png b/gitbook/.gitbook/assets/armadillo-blocks_viewer.png
diff --git a/gitbook/.gitbook/assets/armadillo-connectivity_viewer.png b/gitbook/.gitbook/assets/armadillo-connectivity_viewer.png
diff --git a/gitbook/.gitbook/assets/armadillo-interfaces_viewer.png b/gitbook/.gitbook/assets/armadillo-interfaces_viewer.png
diff --git a/gitbook/.gitbook/assets/armadillo_breps_ghosted.png b/gitbook/.gitbook/assets/armadillo_breps_ghosted.png
diff --git a/gitbook/.gitbook/assets/compas-ui.gif b/gitbook/.gitbook/assets/compas-ui.gif
diff --git a/gitbook/.gitbook/assets/image (1).png b/gitbook/.gitbook/assets/image (1).png
diff --git a/gitbook/.gitbook/assets/image (10).png b/gitbook/.gitbook/assets/image (10).png
diff --git a/gitbook/.gitbook/assets/image (11).png b/gitbook/.gitbook/assets/image (11).png
diff --git a/gitbook/.gitbook/assets/image (12).png b/gitbook/.gitbook/assets/image (12).png
diff --git a/gitbook/.gitbook/assets/image (13).png b/gitbook/.gitbook/assets/image (13).png
diff --git a/gitbook/.gitbook/assets/image (14).png b/gitbook/.gitbook/assets/image (14).png
diff --git a/gitbook/.gitbook/assets/image (15).png b/gitbook/.gitbook/assets/image (15).png
diff --git a/gitbook/.gitbook/assets/image (16).png b/gitbook/.gitbook/assets/image (16).png
diff --git a/gitbook/.gitbook/assets/image (2).png b/gitbook/.gitbook/assets/image (2).png
diff --git a/gitbook/.gitbook/assets/image (3).png b/gitbook/.gitbook/assets/image (3).png
diff --git a/gitbook/.gitbook/assets/image (4).png b/gitbook/.gitbook/assets/image (4).png
diff --git a/gitbook/.gitbook/assets/image (5).png b/gitbook/.gitbook/assets/image (5).png
diff --git a/gitbook/.gitbook/assets/image (6).png b/gitbook/.gitbook/assets/image (6).png
diff --git a/gitbook/.gitbook/assets/image (7).png b/gitbook/.gitbook/assets/image (7).png
diff --git a/gitbook/.gitbook/assets/image (8).png b/gitbook/.gitbook/assets/image (8).png
diff --git a/gitbook/.gitbook/assets/image (9).png b/gitbook/.gitbook/assets/image (9).png
diff --git a/gitbook/.gitbook/assets/image.png b/gitbook/.gitbook/assets/image.png
diff --git a/gitbook/.gitbook/assets/try_crossvault_blocks-rhino.png b/gitbook/.gitbook/assets/try_crossvault_blocks-rhino.png
diff --git a/gitbook/README.md b/gitbook/README.md
@@ -0,0 +1,71 @@
+---
+description: Practical Assessment Tools for Historic Masonry Structures
+---
+
+# COMPAS Masonry
+
+{% hint style="warning" %}
+Note that this website is under construction and will be updated frequently!
+{% endhint %}
+
+[![DOI](https://zenodo.org/badge/458133035.svg)](https://zenodo.org/badge/latestdoi/458133035)
+
+**COMPAS Masonry** is a computational toolbox for the stability assessment of historic masonry structures under various loading conditions.
+
+The assessment and preservation of (historic) masonry structures is a complex engineering problem that requires specific analysis tools and collaboration between various experts to determine if a structure is still safe, especially after significant settlements or changing boundary conditions.
+
+COMPAS Masonry integrates different numerical analysis methods in a unified framework, offering a wide range of assessment options to both academic researchers and professional engineers.
+
+## Open source collaboration
+
+COMPAS Masonry is built on top of [COMPAS](https://compas.dev/), an open-source framework for research and collaboration in Architecture, Engineering, Fabrication, and Construction.
+
+Like COMPAS, COMPAS Masonry is entirely open source and free and based on peer-reviewed, state-of-the-art research.
+
+## AEC Software
+
+COMPAS Masonry is developed independently of CAD applications. As a result, it can be integrated with different CAD software. Currently, implementations are available for Rhino 6+ and Blender.
+
+<figure><img src=".gitbook/assets/image (11).png" alt=""><figcaption><p>Compas TNO in Rhinoceros finding admissible stress states in vaulted masonry structures.</p></figcaption></figure>
+
+Beyond CAD applications, COMPAS masonry user interface is also available through a standalone UI, enabling the structural analysis entirely from Python.
+
+![Equilibrium of two blocks computed with COMPAS RBE visualised in the Python Viewer](.gitbook/assets/compas-ui.gif)
+
+## Data structure
+
+COMPAS Masonry offers a data management structure which makes it easy to work with discrete masonry elements.
+
+From the point of view of geometry, having multiple discrete elements bring a layer of geometric complexity which is dealt with by the data structure developed. Furthermore, COMPAS Masonry enables data exchange between solvers and stores various masonry mechanics properties.
+
+## Working with real data
+
+Geometry acquisition is a big challenge when assessing masonry structures. This acquisition is usually the result of laser scan and photogrammetry processes, which are not directly integrated with the structural analysis. COMPAS Masonry has specific algorithms and routines that ease this conversion process and allows working with surveyed data such as point clouds.
+
+![Point Cloud Survey of the dome in the Santo Agostino Church, Anagni, Italy. Courtesy P. Fuentes and S. Guerra, 2019.](<.gitbook/assets/image (12).png>)
+
+## Parametric Geometries
+
+As an alternative to surveyed data, parametric geometry models are crucial for assessing existing structures or for more theoretical research studies on masonry. For this purpose, inside COMPAS Masonry, the parametric models for generating the most common historical structural typologies have been implemented. Staggered walls, rounded or pointed arches, pavilion and cross vaults, and domes can be quickly generated with a varying span, thickness, springing angles, and block dimensions.&#x20;
+
+![Parametric Geometries created wth COMPAS masosnry correspsonding to commom masonry typologies.](https://lh5.googleusercontent.com/ilnXqOKT6xmuz\_Zc4v8bbHFbRNsKUeDNM6PJj1b3Wr\_PINhDyU\_Nd6tZzY3rVc\_xGPcHX-l-O9KwTrbY7zMf324J\_b61K7maa3yNsyfxlnhmg8r7t1DstoOAv7KLXB4kB4m2qW2d)
+
+## **State-of-the-art equilibrium solvers**
+
+Within the COMPAS Masonry project, a series of state-of-the-art equilibrium solvers has been developed and implemented. Among these solvers are Rigid-Block equilibrium (RBE), Coupled Rigid-Block Analysis (CRA), Piecewise-Rigid Displacement (PRD), and Thrust Network Analysis (TNA).
+
+![Extensions of COMPAS associated with COMPAS Masonry.](<.gitbook/assets/image (5).png>)
+
+These solvers are developed in separated sub-packages and integrated through COMPAS Masonry. For more information about each solver, visit our [solvers page](broken-reference).
+
+## Interface with professional software
+
+COMPAS masonry can provide an interface to professional software such as the Discrete Element Modelling software 3DEC by Itasca. 3DEC files with geometrical data and the analysis setup can be directly generated through COMPAS masonry. Moreover, after the analysis, 3DEC results can be post-processed using customised scripts and visualised together with the deformed geometry in the COMPAS viewer or other CAD software, plotting useful information for the structural assessment.
+
+<figure><img src=".gitbook/assets/image (1).png" alt=""><figcaption><p>Collapse of pavillion vault after support displacements. (Dell'Endice et al., 2021)</p></figcaption></figure>
+
+More details about the development of such application can be found in the [professional software page](broken-reference).
+
+## Funding
+
+The present work was supported by the SNSF - Swiss National Science Foundation. Project grant n 178953: “Practical Stability Assessment Strategies for Vaulted Unreinforced Masonry Structures”. More details about the research output of this project are available [here](additional-info/snsf-project.md).
diff --git a/gitbook/SUMMARY.md b/gitbook/SUMMARY.md
@@ -0,0 +1,36 @@
+# Table of contents
+
+* [COMPAS Masonry](README.md)
+
+## Quickstart
+
+* [Installation](quickstart/installation.md)
+* [Tutorial](quickstart/tutorial.md)
+
+## Assemblies
+
+* [Dome](assemblies/dome.md)
+* [Cross Vault](assemblies/cross-vault.md)
+* [Pavilion Vault](assemblies/pavilion-vault.md)
+* [Armadillo Vault](assemblies/armadillo-vault.md)
+* [Striatus](assemblies/striatus.md)
+
+## Analysis Methods
+
+* [Rigid Block Equilibrium](analysis-methods/rigid-block-equilibrium.md)
+* [Coupled Rigid Block Analysis](analysis-methods/coupled-rigid-block-analysis.md)
+* [Piecewise Rigid Displacement](analysis-methods/piecewise-rigid-displacement.md)
+* [Thrust Network Analysis](analysis-methods/thrust-network-analysis.md)
+* [Discrete Element Method](analysis-methods/discrete-element-method.md)
+
+## Documentation
+
+* [User Guide](documentation/user-guide.md)
+* [Developer Guide](documentation/developer-guide.md)
+
+## Additional Information <a href="#additional-info" id="additional-info"></a>
+
+* [SNSF Project](additional-info/snsf-project.md)
+* [Publications](additional-info/publications.md)
+* [Workshops](additional-info/workshops.md)
+* [Presentations](additional-info/presentations.md)
diff --git a/gitbook/additional-info/presentations.md b/gitbook/additional-info/presentations.md
@@ -0,0 +1,14 @@
+# Presentations
+
+A few selected workshops executed during the development of COMPAS Masonry are listed here.
+
+## Presentations in the Structural Analysis of Historic Structures conference (SAHC 2020/2021)
+
+Three papers using COMPAS Masonry were submited to the SAHC 2020/2021 conference which took place virtually in Barcelona. Some of the talks recorded are available here For the full access to the papers, please go to the [Publications](publications.md) page.
+
+{% embed url="https://www.youtube.com/watch?v=tdLhCW0VGHA" %}
+
+
+
+{% embed url="https://www.youtube.com/watch?v=qogBzw9oWGw" %}
+
diff --git a/gitbook/additional-info/publications.md b/gitbook/additional-info/publications.md
@@ -0,0 +1,27 @@
+# Publications
+
+A list with the publications originated from the COMPAS Masonry project is available below. By following the specfied links the publications can be downloaded.
+
+### Publications
+
+1. Kao, G. T. C., Iannuzzo, A., Thomaszewski, B., Coros, S., Van Mele, T., & Block, P. (2022). Coupled Rigid-Block Analysis: Stability-Aware Design of Complex Discrete-Element Assemblies. Computer-Aided Design, 103216. \[[link](https://www.sciencedirect.com/science/article/pii/S0010448522000161)]
+2. Maia Avelino, R., Van Mele, T., & Block P. (2022) Advances in Thrust Network Analysis: Constrained equilibrium assessment of masonry vaulted structures.Collection of papers - Edoardo Benvenuto Prize Fondazione Franzoni ETS. To be published.
+3. Maia Avelino, R., Lee, J., Van Mele, T., & Block, P. (2021). An interactive implementation of algebraic graphic statics for geometry-based teaching and design of structures. In Proceedings of the International fib Symposium on the Conceptual Design of Structures (pp. 447-454). \[[link](https://www.block.arch.ethz.ch/brg/publications/1110)]
+4. Maia Avelino, R. M., Iannuzzo, A., Van Mele, T., & Block, P. (2021). Assessing the safety of vaulted masonry structures using thrust network analysis. Computers & Structures, 257, 106647.  \[[link](https://www.sciencedirect.com/science/article/pii/S0045794921001693)]
+5. COMPAS Masonry: [https://blockresearchgroup.gitbook.io/compas-masonry/ ](https://blockresearchgroup.gitbook.io/compas-masonry/)
+6. Iannuzzo, A., Dell’Endice, A., Maia Avelino, R., Kao, G. T. C., Van Mele, T., & Block, P. (2021). COMPAS masonry: a computational framework for practical assessment of unreinforced masonry structures. In Proceedings of the SAHC Symposium. \[[link](https://www.block.arch.ethz.ch/brg/publications/1001)]
+7. Iannuzzo, A., Mele, T. V., & Block, P. (2021). Stability and load-bearing capacity assessment of a deformed multi-span masonry bridge using the PRD method. International Journal of Masonry Research and Innovation, 6(4), 422-445. \[[link](https://www.inderscienceonline.com/doi/abs/10.1504/IJMRI.2021.118842)]
+8. Dell’Endice, A., Iannuzzo, A., Van Mele, T., & Block, P. (2021). Influence of settlements and geometrical imperfections on the internal stress state of masonry structures. In Proceedings of the SAHC symposium. \[[link](https://www.block.arch.ethz.ch/brg/publications/1030)]
+9. Maia Avelino, R., Iannuzzo, A., Van Mele, T., & Block, P. (2021). New strategies to assess the safety of unreinforced masonry structures using thrust network analysis. In 12th International Conference on Structural Analysis of Historical Constructions (SAHC) (pp. 2124-2135). International Centre for Numerical Methods in Engineering (CIMNE). \[[link](https://www.block.arch.ethz.ch/brg/publications/1000)]
+10. Kao, G. T. C., Iannuzzo, A., Coros, S., Van Mele, T., & Block, P. (2021). Understanding the rigid-block equilibrium method by way of mathematical programming. Proceedings of the Institution of Civil Engineers-Engineering and Computational Mechanics, 174(4), 178-192. \[[link](https://www.icevirtuallibrary.com/doi/abs/10.1680/jencm.20.00036)]
+11. Maia Avelino, R., Iannuzzo, A., Van Mele, T., & Block, P. (2021). Parametric stability analysis of groin vaults. Applied Sciences, 11(8), 3560. \[[link](https://doi.org/10.3390/app11083560)]
+12. Iannuzzo, A., Dell'Endice, A., Van Mele, T., & Block, P. (2021). Numerical limit analysis-based modelling of masonry structures subjected to large displacements. Computers & Structures, 242, 106372. \[[link](https://www.sciencedirect.com/science/article/pii/S0045794920301759)]
+13. Dell'Endice, A., Iannuzzo, A., DeJong, M. J., Van Mele, T., & Block, P. (2021). Modelling imperfections in unreinforced masonry structures: Discrete Element simulations and scale model experiments of a pavilion vault. Engineering Structures, 228, 111499. \[[link](https://doi.org/10.1016/j.engstruct.2020.111499)]
+14. Iannuzzo, A., Van Mele, T., & Block, P. (2020). Piecewise rigid displacement (PRD) method: a limit analysis-based approach to detect mechanisms and internal forces through two dual energy criteria. Mechanics Research Communications, 107, 103557. \[[link](https://doi.org/10.1016/j.mechrescom.2020.103557)]
+
+Papers in preparation or submitted for review:&#x20;
+
+1. Dell’Endice A., DeJong M.J., Van Mele T., & Block P., Structural Analysis of Unreinforced Masonry Spiral Staircases using Discrete Element Modelling. _Submitted for review_&#x20;
+2. Fugger R, Maia Avelino R, Iannuzzo A, de Felice G., & Block P. A new numerical limit analysis-based strategy to retrofit masonry curved structures with FRCM systems. _Submitted for review_ - ECCOMAS2022 Conference&#x20;
+3. Maia Avelino, R., Iannuzzo, A., Van Mele, T., & Block, P. (2022). An energy-based strategy to find internal stress states compatible with general boundary displacements in masonry structures. _In preparation_
+
diff --git a/gitbook/additional-info/snsf-project.md b/gitbook/additional-info/snsf-project.md
@@ -0,0 +1,14 @@
+# SNSF Project
+
+In recent years, our (academic/theoretical) understanding of the behaviour of unreinforced masonry (URM) structures has improved significantly, and many advanced technological solutions for conservation have been developed. However, there is still a lack of appropriate methods and tools that can be used for the assessment of URM structures in every day practice.&#x20;
+
+Therefore, since 2018, the Block Research Group has been working on “Practical Stability Assessment Strategies for Vaulted Unreinforced Masonry Structures” with support of the Swiss National Science Foundation (SNSF). The goal of this research project is to create tools suitable for everyday engineering practice and to develop appropriate analysis strategies for diverse contexts and circumstances related to the availability of time, budget and available data.&#x20;
+
+The SNSF research results are made available to the scientific and professional community through **COMPAS Masonry**. COMPAS Masonry represents a unique computational framework as it provides a common data management system and connects different tools and methodologies altogether. Therefore, it allows to look at the same assessment problem from different perspectives and opens up the possibility to explore several mechanical scenarios comparing different methodological solutions. Nonetheless, as an open-source framework, it offers to the industry, academy and practitioners the unique opportunity to collaborate, participate in a positive loop, where everyone can contribute.
+
+It bundles different solvers that are built up over a common data management system, compas\_assembly, that provides a fast, direct and robust way to handle complex geometries both in terms of geometric data structures (via graph network theories) and material properties distributions. The main tools developed were **compas\_rbe**, **compas\_tno**, **compas\_prd**, **compas\_cra**, and **compas\_dem**. More information regarding each different solver can be found in the [solvers page](broken-reference).
+
+Beyond the computational developement and implementations of the different masonry solvers, the theoretical foundation developed during the project has been communicated though an extensive list of peer-reviewed and journal publications which are listed [here](snsf-project.md#publications).&#x20;
+
+Additionally, the researchers of the project have participated in [workshops](workshops.md) and given [presentations](presentations.md) which are also available through the respective pages.
+
diff --git a/gitbook/additional-info/workshops.md b/gitbook/additional-info/workshops.md
@@ -0,0 +1,24 @@
+# Workshops
+
+A few selected workshops executed during the development of COMPAS Masonry are listed here.
+
+## International Summer School: Historic Masonry Structures (2019-2022)
+
+COMPAS Masonry has been used as a tool by the students of the Masonry Summer School since 2019 to perform structural calculations of historic masonry structure. In this immersive 2-weeks summer school international students visit a city in Europe and inspect a few selected monuments from the comunity such as churches, monasteries, etc. Students are divided in groups and at the end of the course each group must submit a document compiling geometric, architectural and structural features of the monument and, if necessary, suggest interventions.&#x20;
+
+![Booklet of the International Summer School 2021. Source: hismass.org](<../.gitbook/assets/image (6).png>)
+
+For more info check the Summer School Webpage.
+
+* [https://www.himass.org](https://www.himass.org)
+
+## Discrete computational mechanics of Masonry Strutures 2021 (CISM course)
+
+COMPAS Masonry has been used as a tool studied in the Discrete computational mechanics of Masonry Strutures international APT course. This course was organised by the International Centre for Mechanical Sciences (CISM) that took place in 26-30 July 2021 in Udine, Italy.
+
+![Flyer of the discrete computational mechanics of masonry structures course. Source: CISM, 2021.](<../.gitbook/assets/image (13).png>)
+
+More Information about the course:
+
+* [https://www.cism.it/en/activities/courses/A2102/](https://www.cism.it/en/activities/courses/A2102/)
+
diff --git a/gitbook/analysis-methods/coupled-rigid-block-analysis.md b/gitbook/analysis-methods/coupled-rigid-block-analysis.md
@@ -0,0 +1,17 @@
+# Coupled Rigid Block Analysis
+
+![](https://lh3.googleusercontent.com/zaPjTHQjzaR0BLMCb48Umn0ZjizBNgUw31csuJrYF37-PuV9WpsRUh-Xl6P5noQ7ZvhKof\_6jfeZK1JO8iPG8RSp8NgmGHpHmN3mGQbUM-vWT\_owq8kZI2QykuUdT\_PrSuTclKx\_)
+
+The rigid-block equilibrium (RBE) method uses a penalty formulation to measure structural infeasibility or to guide the design of stable discrete-element assemblies from unstable geometry. However, RBE is a purely force-based formulation, and it incorrectly describes stability when complex interface geometries are involved. Coupled rigid-block analysis (CRA) method is a more robust approach that builds upon RBE’s strengths and overcomes the aforementioned issues. The CRA method combines equilibrium and kinematics in a penalty formulation in a nonlinear programming problem. CRA enables accurate modelling of complex three-dimensional discrete-element assemblies formed by rigid blocks. CRA’s accuracy is benchmarked against widely used software in engineering practice and demonstrated through physical models.
+
+## compas\_cra
+
+compas\_cra provides a base implementation of CRA. Additionally, _compas\_cra_ can also be applied to masonry with curved interfaces.
+
+{% embed url="https://blockresearchgroup.github.io/compas_cra" %}
+compas\_cra docummentation
+{% endembed %}
+
+{% embed url="https://github.com/BlockResearchGroup/compas_cra" %}
+compas\_cra open-source repository
+{% endembed %}
diff --git a/gitbook/analysis-methods/discrete-element-method.md b/gitbook/analysis-methods/discrete-element-method.md
@@ -0,0 +1,5 @@
+# Discrete Element Method
+
+![](../.gitbook/assets/image.png)
+
+Discrete Element Modelling (DEM) is a method able to analyse structures composed of multiple bodies. The motion of the blocks in the DEM method is described by Newton’s second law and solved numerically by the central difference method with respect to a scalar parameter (e.g. time). The position of the blocks during the calculation is updated step by step. Two different kinds of analyses are possible, static and dynamic, and both solved with explicit numerical algorithms. In DEM, the blocks can be considered rigid or deformable, and Mohr-Coulomb failure criteria can be used to model the joints. Moreover, the blocks can move and deform independently with respect to each other; they can get completely separate, and they can form new contacts with other blocks during the analysis. Since the blocks can be considered rigid and the contact interfaces with no tensile strength, this method is suitable for the investigation of the behaviour of unreinforced masonry structures.