README.md

Augmented reality (AR) visualization pipeline

Software Requirements

• To create augmented reality (AR) models you will require the following packages:
  • ParaView 5.10
  • Blender 2.83
  • BlenderUSDZ addon
  • MacOS users: Apple Reality Converter
  • Windows/Unix users: Apple usdzconvert utility
• To host and render the AR models you will need to include the model-viewer API within your webpage.

File Description

We provide '.ply' files of results from finite element simulations discretized with i) continuum, ii) shell, and iii) beam finite elements. Please note, the above mentioned finite element discretizations may be substituted with other types of scientific data represented by volumes, surfaces, and curves in 3D space, respectively. The '.ply' files are located within similarly named subfolders under the "PLY_Files/" directory. Moreover, we provide '.glb' and '.usdz' files of the AR models corresponding to these results.

Code Description

We provide example python scripts to automatically create AR models from continuum, shell, and beam finite elements. These scripts may be run from the 'Scripting' window within Blender or from the command line. To execute these scripts, users will need the '.ply' files provided for each example. The pythons scrips are as follows:

1. Static Models

• Supplementary_Script_1a.py : Model with continuum elements
• Supplementary_Script_1b.py : Model with shell elements
• Supplementary_Script_1c.py : Model with beam elements

2. Dynamic Models for Android

• Supplementary_Script_2a.py : Model with continuum elements
• Supplementary_Script_2b.py : Model with shell elements
• Supplementary_Script_2c.py : Model with beam elements

3. Dynamic Models for iOS

• Supplementary_Script_3a.py : Model with continuum elements
• Supplementary_Script_3b.py : Model with shell elements
• Supplementary_Script_3c.py : Model with beam elements

References

If you find this repository useful for your research, please cite the following work:

@article{Mathur2023AR,
author = {Mathur, Mrudang and Brozovich, Josef M. and Rausch, Manuel K.},
doi = {10.1016/j.finel.2022.103851},
issn = {0168874X},
journal = {Finite Elements in Analysis and Design},
number = {September 2022},
publisher = {Elsevier B.V.},
title = {{A brief note on building augmented reality models for scientific visualization}},
volume = {213},
year = {2023}
}

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.