Thermo-elasticTopologyOptimization/README.md

# Thermo-elastic/Mechanical Topology Optimization/Simuation
![Screenshot from 2023-07-02 13-57-29.png](docs%2Fimgs%2FScreenshot%20from%202023-07-02%2013-57-29.png)
<b> (Optional) temperature limits, optimization of voxel mesh. </b>

This is the implementation of the paper [Thermo-elastic topology optimization with stress
and temperature constraints.](ref%2FThermo-elastic%20topology%20optimization%20with%20stress%0Aand%20temperature%20constraints.pdf)
By the way, this procedure realized the thermo-elastic TO(topology optimization)([Thermo-elastic topology optimization with stress
and temperature constraints.](ref%2FThermo-elastic%20topology%20optimization%20with%20stress%0Aand%20temperature%20constraints), mechanical TO([top3d.pdf](ref%2Ftop3d.pdf)) and corresponding simulations.

## Files
* `3rd/`: third-party library
* `assets/`: user-defined assets
* `examples/`: several teaching examples
   - `defined_model_writer`: User defined voxel mesh/model as TO/simulation input.
   - `clamped_model_writer`: Clamped to 0 or 1 of the optimized density.
   - `sim_mechanical`: Mechanical simulation.
   - `sim_thermoelastic`: Thermo-elastic simulation.
   - `top_mechanical`: Mechanical TO.
   - `top_thermoelastic`: Thermoelastic TO.
* `output/`: output directory
* `ref/`: reference material
* `src/`: source code
* `cmake/`: CMake files

## Dependencies
**Inside libraries**:
* [mma](3rd%2Fmma): constrained optimization algorithm
* [Eigen](https://eigen.tuxfamily.org/): linear algebra
* [libigl](https://github.com/libigl/libigl): basic geometry functions
* [AMGCL](https://github.com/ddemidov/amgcl): Linear solver. Optional.
* 
**The following dependencies require user installation**:
* [json](https://github.com/nlohmann/json): parsing input JSON scenes
* [spdlog](https://github.com/gabime/spdlog): logging information
* OpenMP: CPU parallel processing. 
```bash
sudo apt install libomp-dev
```
* [SuiteSparse](https://github.com/DrTimothyAldenDavis/SuiteSparse): Linear solver. Optional, NOTE: Use of the Intel MKL BLAS is strongly recommended.
* [CUDA Toolkit](https://developer.nvidia.com/cuda-toolkit): CUDA support. Optional (Suggested).

**Select a Linear solver**

If your matrix has less than **50w** of freedom, then it is recommended to choose a direct solver (e.g. SuiteSparse):
1. install SuiteSparse.
2. Set `ENABLE_AMGCL` to `OFF` and set `ENABLE_SUITESPARSE` to `ON` in 
[CMakeLists.txt](CMakeLists.txt).

Otherwise, it is recommended to choose an iterative solver (e.g. AMGCL),in CPU:
1. install OpenMP and AMGCL.
2. Set `ENABLE_AMGCL` to `ON`, `ENABLE_AMGCL_CUDA` to `OFF` and `ENABLE_SUITESPARSE` to `OFF` in [CMakeLists.txt](CMakeLists.txt).

Further, CUDA can be used to speed up the iterative solver:
1. install OpenMP, CUDA Toolkit and AMGCL.
2. Set `ENABLE_AMGCL` to `ON`, `ENABLE_AMGCL_CUDA` to `ON` and `ENABLE_SUITESPARSE` to `OFF` in [CMakeLists.txt](CMakeLists.txt).

Finally, if all options are set to `OFF`, then the Eigen build-in iterative solver will be chosen.(not recommended).

## Build
1. set path in
   [CMakeLists.txt](CMakeLists.txt).
```cmake
set(CMAKE_CUDA_COMPILER "/path/to/nvcc") # set path to nvcc
```
2. 
```bash
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j 16
```

## Usage
### 3/28 update
1. Use `example/top-thermolastic-compare-3d` to run mechanical(Me)/mechanical thermal(MeTh) topology optimization(Top) and simulation(Sim).
The procedure run in following order: 
   1. Me Top & MeTh Top -> density(*_MeTop_rho.vtk & *_MethTop_rho.vtk) and compliance/volume each iteration(*_MeTop_compliance.txt *_MeTop_volume.txt & ...)
   2. clamp density by different threshold(.XX) -> 0/1 density(*_MeSim_threshXX_rho.vtk & *_MeThSim_threshXX_rho.vtk)
   3. MeTh Sim -> temperature(*_T.vtk), displacement(*_U.vtk), Von Mise Stress(*_von_stress.vtk).
Note: open .vtk via Paraview software.
2. Input 
   1. Set parameters in *.json. see comments in `assets/top-thermoelastic-*.json`(see comments in `assets/config_biclamed.json` and ref paper for MeTh parameters; see comments in `assets/top/config_Lshape.json`)
   2. Redirect in `main.cpp` or `main.cu` if ENABLE_AMGCL_CUDA is ON:
3. Output see `output/txt/${example_name}/${example_name}_*` and `output/vtk/${example_name}/${example_name}_*`.
---

1. See `example/top-thermoelastic-BiclampedStructure` or `examples/top-thermoelastic-Lshape-condition`.

NOTE:
1. `"//*"` in `examples/*/config.json` file mean comments.
2. you can modify `CONFIG_FILE`, `OUTPUT_DIR` and `ASSETS_DIR` in `examples/*/CMAKEList.txt`.
3. you can modify the linear solver arguments `prm.solver.tol` and `prm.solver.maxiter`  in `src/LinearSolver/Amgcl.h` or `src/LinearSolver/AmgclCuda.h`. 
4. you should modify example content in `*.cpp` rather than `*.cu`, the latter is copied from the former by cmake.