Xcompact3d-toolbox

Fixed

- Specified the version for netcdf4, to avoid a issues with the latest version ([13](https://github.com/fschuch/xcompact3d_toolbox/issues/13)), by [fschuch](https://github.com/fschuch).

Modified

- Support for parallel computing with dask was extended at `genepsi.gene_epsi_3D`, by [fschuch](https://github.com/fschuch).

Added

- Add `sandbox.Geometry.from_stl`. It reads an `stl` file and is able to compute what mesh points are inside or outside the geometry, so we can specify the geometry for a very customized immersed boundary method. By [fschuch](https://github.com/fschuch) and [nbeb](https://github.com/nbeb).
- Add `xcompact3d_toolbox.tutorial`, making it easier to get datasets for documentation and tutorials, by [fschuch](https://github.com/fschuch).
- Add `xcompact3d_toolbox.Parameters.from_string`, an useful method to get the parameters from the datasets at the tutorials, by [fschuch](https://github.com/fschuch).
- Add tutorial **Computing and Plotting**, by [fschuch](https://github.com/fschuch).
- Add tutorial **Reading and writing files**, by [fschuch](https://github.com/fschuch).

Modified

- `io.Dataset.data_path` is now obtained automatically from `parameters.Parameter.filename` at initialization (i.g., if `filename = "./example/input.i3d"` then `data_path = "./example/data/"`). Of course, `data_path` can be changed to any value after that. By [fschuch](https://github.com/fschuch).
- `io.Dataset.load_wind_turbine_data` now have a default location for `file_pattern`. Atributes were included for the coordinate time. By [fschuch](https://github.com/fschuch).
- `io.Dataset.set` now accepts keyword arguments to send to `io.FilenameProperties.set`, for a more concise sintaxe. By [fschuch](https://github.com/fschuch).
- The default return from `xcompact3d.param.boundary_condition` now takes in consideration if the domain is periodic or not, by [fschuch](https://github.com/fschuch).

Fixed

- `fix_bug` at [gene_epsi_3D](xcompact3d-toolbox/genepsi.py) was not working properly ([3](https://github.com/fschuch/xcompact3d_toolbox/issues/3)), by [fschuch](https://github.com/fschuch).
- `xcompact3d.io.Dataset.load_array` was not working for files that do not change in time, like `./data/geometry/epsilon.bin`, by [fschuch](https://github.com/fschuch).

Modified

- Rename the default branch to `main`, by [fschuch](https://github.com/fschuch).

Added

- Add `load_wind_turbine_data` that reads the files from the disc and wraps the data into a `xarray.Dataset`, by [fschuch](https://github.com/fschuch).

Fixed

- `Black` version was not working properly at `setup.py`, by [fschuch](https://github.com/fschuch).

Xcompact3d-toolbox has evolved considerably in the last year. The pre-release version has been employed in CFD research projects, and the feedback from the users helped to improve its interfaces and functionalities. The integration between this Python package and the numerical solver [XCompact3d](https://github.com/xcompact3d/Incompact3d) was experimental, and many of the functionalities were only available in a forked repository for a test of concept ([fschuch/Xcompact3d](https://github.com/fschuch/Xcompact3d)). These features are now part of the main repository [XCompact3d](https://github.com/xcompact3d/Incompact3d) (see [PR #51](https://github.com/xcompact3d/Incompact3d/pull/51)). With this, Xcompact3d-toolbox is ready for its first stable release.

Added

- Support for stretched mesh at the xdmf writer and automatized tests for it, by [fschuch](https://github.com/fschuch).
- A class to handle the binary filenames and their tests. Now all methods support different filenames, like the classic `ux000`, or the new `ux-0000.bin`, besides some combinations between them. By [fschuch](https://github.com/fschuch).
- Classes to handle the coordinates and their tests, so they can be moved out of the parameters class, by [fschuch](https://github.com/fschuch).
- New class for the 3D coordinate system, with useful methods and its testes, by [fschuch](https://github.com/fschuch).
- Add `class Dataset` to read the binary files from XCompact3d on-demand, it is possible to loop through the snapshots, select any of them or read the entire time-series for a given variable. It returns them in a proper `xarray.Dataset`, by [fschuch](https://github.com/fschuch).
- Sets of dependencies for extra functionalities, like docs, tests, and visu, by [fschuch](https://github.com/fschuch).
- More parameters are now covered in the Parameters class, by [fschuch](https://github.com/fschuch).
- Add type hints to many functions and class methods, for a better development experience using modern IDEs, by [fschuch](https://github.com/fschuch).

Modified

- Writing methods for the binary files were moved from the xarray accessors to the Dataset class, by [fschuch](https://github.com/fschuch).
- The new sandbox flow configuration is now set with `itype = 12`, following its addition the XCompact3d's main repository (see [51](https://github.com/xcompact3d/Incompact3d/pull/51)), by [fschuch](https://github.com/fschuch).
- The documentation was improved, by [fschuch](https://github.com/fschuch).

Fixed

- Not installing all dependencies with `pip install`, by [fschuch](https://github.com/fschuch).
- Suppressed warning from `tqdm`, by [fschuch](https://github.com/fschuch).
- The output format from `gene_epsi_3D` has changed, fixing some compatibility issues with XCompact3d as well (see [51](https://github.com/xcompact3d/Incompact3d/pull/51)), by [fschuch](https://github.com/fschuch).

Fixed
- Fix 8, a little incompatibility problem with xcompact3d was fixed, by [fschuch](https://github.com/fschuch).

Added
- Add support for the previous parameters format `.prm` (7), by [fschuch](https://github.com/fschuch).
- Class `ParametersGui`, a subclass from `Parameters`, but with widgets, by [fschuch](https://github.com/fschuch).
- Argument `loadfile` added to class `Parameters`, so it is possible to initialize and load form the disc with just one line of code `prm = x3d.Parameters(loadfile='example.i3d')`, by [fschuch](https://github.com/fschuch).

Changed
- Changed from method `__call__` to `__repr__` at `parameters.py` as the procedure to show the parameters on screen, by [fschuch](https://github.com/fschuch).
- Functions to read binary fields where moved from `io.py` to methods at `parameters.py`, so the syntax is simplified from `x3d.read_field('filename', prm)` to just `prm.read_field('filename')`. by [fschuch](https://github.com/fschuch).

Fixed
- Scale factor for Ahmed Body at the sandbox, by [fschuch](https://github.com/fschuch).
- Fix 2, widgets are now working in a new class `ParametersGui`, by [fschuch](https://github.com/fschuch).
- Fix 5, Bug at Ahmed body when using double-precision, by [fschuch](https://github.com/fschuch).
- Fix 6, The files describing the geometry are incompatible when running on Linux, by [fschuch](https://github.com/fschuch).