Metadata-Version: 2.1
Name: pyhesive
Version: 0.2.2
Summary: Insert cohesive elements into any mesh
Home-page: https://gitlab.com/Jfaibussowitsch/pyhesive
Author: Jacob Faibussowitsch
Author-email: jacob.fai@gmail.com
License: UNKNOWN
Description: <!-- SHIELDS -->
        [![MIT License][license-shield]][license-url]
        [![Version][version-shield]][version-url]
        [![PyVersion][pyversion-shield]][pyversion-url]
        
        <!-- TABLE OF CONTENTS -->
        <details open="open">
          <summary><h2 style="display: inline-block">Table of Contents</h2></summary>
          <ol>
            <li>
              <a href="#about-the-project">About The Project</a>
        	  <ul>
                <li><a href="#supported-mesh-formats">Supported Mesh Formats</a></li>
              </ul>
              <ul>
                <li><a href="#built-with">Built With</a></li>
              </ul>
            </li>
            <li>
              <a href="#getting-started">Getting Started</a>
              <ul>
                <li><a href="#installation">Installation</a></li>
              </ul>
        	  <ul>
        		<li><a href="#example-usage">Example Usage</a></li>
        	  </ul>
            </li>
          </ol>
        </details>
        
        <!-- ABOUT THE PROJECT -->
        ## About The Project
        
        Simple, extensible python library to read a finite element mesh and insert cohesive
        elements. Meshes are partitioned into sectors using METIS mesh partitioner, and cohesive
        elements are inserted between partitions. This allows an arbitrary level of insertion
        (controlled primarily by the number of partitions) without the user needing to specify
        cumbersome face-sets along which to insert.
        
        ![](https://gitlab.com/Jfaibussowitsch/pyhesive/-/raw/master/images/pyhesive-algo.png)
        
        ### Supported Mesh Formats
        
        > [Abaqus](http://abaqus.software.polimi.it/v6.14/index.html),
         [ANSYS msh](https://www.afs.enea.it/fluent/Public/Fluent-Doc/PDF/chp03.pdf),
         [AVS-UCD](https://lanl.github.io/LaGriT/pages/docs/read_avs.html),
         [CGNS](https://cgns.github.io/),
         [DOLFIN XML](https://manpages.ubuntu.com/manpages/disco/man1/dolfin-convert.1.html),
         [Exodus](https://cubit.sandia.gov/public/13.2/help_manual/WebHelp/finite_element_model/exodus/block_specification.htm),
         [FLAC3D](https://www.itascacg.com/software/flac3d),
         [H5M](https://www.mcs.anl.gov/~fathom/moab-docs/h5mmain.html),
         [Kratos/MDPA](https://github.com/KratosMultiphysics/Kratos/wiki/Input-data),
         [Medit](https://people.sc.fsu.edu/~jburkardt/data/medit/medit.html),
         [MED/Salome](https://docs.salome-platform.org/latest/dev/MEDCoupling/developer/med-file.html),
         [Nastran](https://help.autodesk.com/view/NSTRN/2019/ENU/?guid=GUID-42B54ACB-FBE3-47CA-B8FE-475E7AD91A00) (bulk data),
         [Neuroglancer precomputed format](https://github.com/google/neuroglancer/tree/master/src/neuroglancer/datasource/precomputed#mesh-representation-of-segmented-object-surfaces),
         [Gmsh](http://gmsh.info/doc/texinfo/gmsh.html#File-formats) (format versions 2.2, 4.0, and 4.1),
         [OBJ](https://en.wikipedia.org/wiki/Wavefront_.obj_file),
         [OFF](https://segeval.cs.princeton.edu/public/off_format.html),
         [PERMAS](https://www.intes.de),
         [PLY](https://en.wikipedia.org/wiki/PLY_(file_format)),
         [STL](https://en.wikipedia.org/wiki/STL_(file_format)),
         [Tecplot .dat](http://paulbourke.net/dataformats/tp/),
         [TetGen .node/.ele](https://wias-berlin.de/software/tetgen/fformats.html),
         [SVG](https://www.w3.org/TR/SVG/) (2D only, output only),
         [SU2](https://su2code.github.io/docs_v7/Mesh-File),
         [UGRID](http://www.simcenter.msstate.edu/software/downloads/doc/ug_io/3d_grid_file_type_ugrid.html),
         [VTK](https://www.vtk.org/wp-content/uploads/2015/04/file-formats.pdf),
         [VTU](https://www.vtk.org/Wiki/VTK_XML_Formats),
         [WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) ([TIN](https://en.wikipedia.org/wiki/Triangulated_irregular_network)),
         [XDMF](http://www.xdmf.org/index.php/XDMF_Model_and_Format).
        
        Mesh I/O is facilitated by [meshio](https://github.com/nschloe/meshio), see meshio
        documentation for up-to-date list of supported mesh formats.
        
        ### Built With
        
        * [numpy](https://numpy.org/)
        * [scipy](https://www.scipy.org/)
        * [pymetis](https://github.com/inducer/pymetis)
        * [meshio](https://github.com/nschloe/meshio)
        
        <!-- GETTING STARTED -->
        ## Getting Started
        
        To get a local copy up and running follow these simple steps.
        
        ### Installation
        
        * Install via [pip](https://pypi.org/project/pyhesive/)
           ```sh
           pip install pyhesive
           ```
        
        * Clone the repo
           ```sh
           git clone https://gitlab.com/Jfaibussowitsch/pyhesive.git
           ```
        
        ### Example Usage
        
        * [**RECOMMENDED**] Command line script
          ```sh
          pyhesive-insert -i /path/to/mesh/file
          ```
          Additional commmand line arguments are listed via
          ```sh
          pyhesive-insert --help
          ```
        
        * Python module import
          ```python
          import pyhesive
        
          # mesh created with meshio
          with pyhesive.Mesh(mesh) as msh:
        	  pyhesMesh.PartitionMesh()
        	  pyhesMesh.GenerateElements()
        	  pyhesMesh.WriteMesh()
          ```
        <!-- MARKDOWN LINKS & IMAGES -->
        <!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
        [license-shield]: https://img.shields.io/pypi/l/pyhesive
        [license-url]: https://gitlab.com/Jfaibussowitsch/pyhesive/-/blob/master/LICENSE
        [version-shield]: https://img.shields.io/pypi/v/pyhesive
        [version-url]: https://pypi.org/project/pyhesive/
        [pyversion-shield]: https://img.shields.io/pypi/pyversions/pyhesive
        [pyversion-url]: https://www.python.org/downloads/
        
Keywords: mesh,scientific,engineering,fem,finite elements,fracture,fracture mechanics,cohesive elements
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.4
Description-Content-Type: text/markdown
