<commit_before>---
layout: page
title: "About"
logo: "img/home-bg.jpg"
description: "About LMG"
header-img: "img/home-bg.jpg"
---

<img src="img/logos/logo.png" alt="LMG_logo" width="100%">
<!-- ![LMG_logo](img/logos/logo.png){:width="100%"} -->

# Table of contents
- [Project Summary](#Summary)  
- [Installation](#Installation)  
- [Getting started](#Start)  
- [License](#License)  
- [Contributing](#Contributing)  
- [Code of conduct](#CodeOfConduct)  
- [Road Map](#RoadMap)  

## Project summary <a name="Summary"></a>
Lumbar Model Generator (LMG) is a MATLAB toolbox for semi-automatic generation of lumbar finite element geometries.
This toolbox allows to obtain:
- the geometrical model of the lumbar spine (from the vertebrae L1 to the L5 including the intervertebral disc IVD);
- the surface models of the bodies involved (STL files);
- the solid meshed model, generated with hexahedral elements for the IVD and tetrahedral elements for the vertebrae;

A work in progress feature is the pre-processing of the solid meshed model to prepare the .feb file to run the finite element simulation in FEBio.

<img src="img/overview.png" alt="LMG overview" width="100%">

# Installation <a name="Installation"></a>  
### 1. Installing 3rd party packages
Skip this step if finite element analysis with FEBio is not required.

| Package | Purpose | Included? | Download |
|:--|:--|:--:|--:|
|[__FEBio__](https://febio.org) <br/> <img src="img/logos/febioLogo.png" href="https://febio.org" alt="FEBIO" width="100%">|FEBio is a finite element solver and is used in LMG for all finite element analysis. |__No__|[__FEBio website__](https://febio.org)|
|[__GIBBON__](https://gibboncode.org) <br/> <img src="img/logos/gibbonlogo.png" href="https://gibboncode.org" alt="GIBBON" height="100px">|GIBBON The Geometry and Image-Based Bioengineering add-On |__No__|[__GIBBON website__](https://gibboncode.org) |
|[__TetGen__]() <br/> <img src="img/logos/tetgenLogo.gif" href="https://wias-berlin.de/software/tetgen/" alt="TetGen" width="100px">| <br/> Is used for tetrahedral meshing (and possibly constrained 3D Delaunay tessellation). `|__Yes__| For other versions: [__TetGen website__](https://wias-berlin.de/software/tetgen/)|

### 2. Run `install_LMG.m`
By running `install_LMG.m` the LMG and FEBio (if needed) path definitions will be added and saved to MATLAB. The help and documentation will also be integrated. Once finished you will be asked to __restart MATLAB__. `install_LMG.m` can be found in the main LMG folder.

## Getting started <a name="Start"></a>
<commit_msg>Fixed About.md 2<commit_after>---
layout: page
title: "About"
logo: "img/home-bg.jpg"
description: "About LMG"
header-img: "img/home-bg.jpg"
---

<img src="img/logos/logo.png" alt="LMG_logo" width="100%">
<!-- ![LMG_logo](img/logos/logo.png){:width="100%"} -->

# Table of contents
- [Project Summary](#Summary)  
- [Installation](#Installation)  
- [Getting started](#Start)  
- [License](#License)  
- [Contributing](#Contributing)  
- [Code of conduct](#CodeOfConduct)  
- [Road Map](#RoadMap)  

## Project summary <a name="Summary"></a>
Lumbar Model Generator (LMG) is a MATLAB toolbox for semi-automatic generation of lumbar finite element geometries.
This toolbox allows to obtain:
- the geometrical model of the lumbar spine (from the vertebrae L1 to the L5 including the intervertebral disc IVD);
- the surface models of the bodies involved (STL files);
- the solid meshed model, generated with hexahedral elements for the IVD and tetrahedral elements for the vertebrae;

A work in progress feature is the pre-processing of the solid meshed model to prepare the .feb file to run the finite element simulation in FEBio.

<img src="img/overview.png" alt="LMG overview" width="100%">

# Installation <a name="Installation"></a>  
### 1. Installing 3rd party packages
Skip this step if finite element analysis with FEBio is not required.

| Package | Purpose | Included? | Download |
|:--|:--|:--:|--:|
|[__FEBio__](https://febio.org) <br/> [![FEBio](/img/logos/febioLogo.png){:height="100px"}](https://febio.org)|FEBio is a finite element solver and is used in GIBBON for all finite element analysis. Use of FEBio is featured in many of the `DEMO_FEBio...` files |__No__|[__FEBio website__](https://febio.org) |
|[__GIBBON__](https://gibboncode.org) <br/> [![export_fig](/img/logos/gibbonlogo.png){:height="100px"}](https://gibboncode.org)| <br/> GIBBON The Geometry and Image-Based Bioengineering add-On |__No__|[__GIBBON website__](https://gibboncode.org) |
|[__export_fig__](https://github.com/altmany/export_fig) <br/> [![export_fig](/img/logos/export_fig_logo.jpg){:height="100px"}](https://github.com/altmany/export_fig)| <br/> `export_fig` helps to export publication quality images (e.g. .png, .jpg, .pdf, .eps), in GIBBON it is integrated in the export figure widget `efw` to export such images from the `cFigure` window directly. `export_fig` is also used for exporting images for creation of .gif animations with the GIBBON `anim8` function |__No__|[__Get via GitHub__](https://github.com/altmany/export_fig) <br/> <br/> [__Download zip__](https://github.com/altmany/export_fig/archive/master.zip)|
|<br/> [__TetGen__]() <br/> [![tetGen](/img/logos/tetgenLogo.gif){:height="100px"}](https://wias-berlin.de/software/tetgen/)| <br/> Is used for tetrahedral meshing (and possibly constrained 3D Delaunay tessellation). See for instance `HELP_runTetGen.m`|__Yes__| For other versions: [__TetGen website__](https://wias-berlin.de/software/tetgen/)|

### 2. Run `install_LMG.m`
By running `install_LMG.m` the LMG and FEBio (if needed) path definitions will be added and saved to MATLAB. The help and documentation will also be integrated. Once finished you will be asked to __restart MATLAB__. `install_LMG.m` can be found in the main LMG folder.

## Getting started <a name="Start"></a>

{'fraction_non_alphanumeric': 0.14616695059625212, 'fraction_numerical': 0.009028960817717206, 'mean_word_length': 4.966463414634147, 'pattern_counts': {'":': 0, '<': 38, '<?xml version=': 0, '>': 38, 'https://': 20, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 3, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1011733', 'n_tokens_mistral': 2066, 'n_tokens_neox': 1902, 'n_words': 611}