Bkm82 docs testing build

[bkm82]

Documentation Updates

• Update the Readme with instructions
• Create a documentation page page

CI/CD Pipeline:

Unit Testing and Code Coverage
Add unit testing with Ceedling and code coverage uploaded to Codecov.

CD Pipeline
Implement a CD pipeline to build binaries for Windows, Linux, and macOS.

Semantic Release Automation:
Integrate semantic release automation. Note: Create the first release to initiate automatic version updates based on commit messages.

Documentation Deployment:
Build and deploy documentation to a =docs= branch. In settings, configure GitHub Pages to source from this branch.

Code Updates

Update "Get_Element_GLobal_Search" in "mesh.c"

Refactor "Get_Element_Global_Search" in ="mesh.c" to implement a pre-check to verify if a point lies within the bounding rectangle before conducting the barycentric search.

1. Check if a points is between a cells x_min/x_max, breaking early if not
2. Repeat step 1 for the y and z directions
3. If within the min/max of each coordinate, perform a barycentric search.

Why: Enhances performance

Update the "InitializeFTLEArray" function in "ftle.c"

Update the "InitializeFTLEArray" function in "ftle.c" to perform a gore efficent global search method.

1. Conduct a local search and record all searched (both found and unfound) points.
2. Perform a global search only for points adjacent to found points, continuing to record searched points.
3. Repeat until there are no unsearched points adjacent to found points, wrapping the entire domain.

Why: The local search alone was insufficient, and this optimization yields approximately a 500x performance gain on initializing the domain for a larger 3D model.

Various Improvements:

Added a debug macro to define three levels of debugging for controlling debug message output.
Add an example setting input file that works with the current version.