Metadata-Version: 2.4
Name: Davout
Version: 0.1.1.dev119
Summary: Scientific computing utilities combining FEM, ANN and tooling
Author: Matheus Janczkowski
Author-email: Matheus Janczkowski <matheusj2009@hotmail.com>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/Matheus-Janczkowski/Davout
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: matplotlib
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# Davout
Repository to store my workhorses and research-themed park. Github link
to the repository and source files: https://github.com/Matheus-Janczkowski/Davout

1. Link to the booklet on installation of a miscelaneous of software: https://www.overleaf.com/read/wbxhncmtnmkm#0eb73b

2. Link to the book on python programming: https://github.com/Matheus-Janczkowski/CompMechSelfStudy/blob/main/introduction_to_python_programming.pdf

3. Link to the booklet on writing using LaTeX: https://www.overleaf.com/read/sdrvfrpdjhft#66d6f9

4. Link to the book on continuum mechanics: https://github.com/Matheus-Janczkowski/CompMechSelfStudy/blob/main/introduction_to_continuum_mechanics.pdf

4. Link for the presentation template: https://www.overleaf.com/read/sbgxdphxswmm#6d7d64

# Citation
https://doi.org/10.5281/zenodo.18806245

All versions: DOI 10.5281/zenodo.18806244

# What does Davout do?
Workhorse for a research project that encompasses finite element 
analysis, machine learning, and multiscale analysis. Additionally, a set 
of tools is provided.

This package contains extensive implementation of hyperelastic problems 
in finite strains using FEniCS and GMSH for mesh generation. A consistent 
and general purpose implementation of ANN models using tensorflow is
also available. 

This suite performs and the corresponding module:
1. Geometry and mesh generation ---------------------------------------------------------> CuboidGmsh
2. Finite element analysis ----------------------------------------------------------------------> MultiMech
3. ANN models definition and training ----------------------------------------------------> DeepMech
4. Post-processing automation using ParaView ---------------------------------------> GraphUtilities
5. Generation of figures, collages, and slides using own graphical tools ----> GraphUtilities
6. LaTeX writing and formating using an ensemble of commands -------------> LaTeXUtilities

# Philosophy and aims
Davout aims to be a unified software to accompany researchers in 
computational mechanics. Davout is inspired by a profound love for python 
and open software.

Davout stands on the shoulders of other massively mighty python packages,
such as FEniCS, TensorFlow, GMSH, ParaView, and matplotlib.

# Installation using pip
pip install Davout

# Installation using installer file
Download the zip file, unzip it and move it to a suitable directory.
Open the Davout folder, where setup.py is located. Open this path in
terminal (using a virtual environment) and run the following command

python davout_installer.py

# Installation using command
Download the repository, unzip the file, put it in a suitable place for you.
Activate a python virtual environment (follow instruction in the booklet 1. 
to create a virtual environment if you don't have one), go into the directory 
where the files are located through the virtual environment terminal. Then, 
type in terminal (instead of python you might need to explicitely type in
the version, like python3):

python setup.py bdist_wheel sdist

pip install .

To test the installation:

python

import Davout
