Agml

Main Changes

- You can now manually generate synthetic data with Helios using your own C++ generation file and CMake parameters/XML style file, using the method `agml.synthetic.manual_generate_data`. This allows for a greater deal of customizability and control over how Helios is compiled, as well as which methods are being used.
- A convenience method `agml.viz.show_sample` has been added which enables quick visualization of an image and its annotations: this works for all types of annotations, simply pass a loader as the argument.

Other Improvements

- If you want to overwrite files when generating synthetic data with the `HeliosDataGenerator`, you can now pass the argument `clear_existing_files = True` to the `generate` method.
- You can now compile Helios using the standard API in both the 'Release' and 'Debug' modes.

*[Read the Full Changelog Here.](https://github.com/Project-AgML/AgML/compare/v0.4.5...v0.4.6)*

This feature adds a couple of new features as well as bugfixes for the existing API.

Main Changes
- You can now use image classification models (`agml.models.ClassificationModel`) as image regression models by passing `regression = True` upon instantiation. This drops the final `argmax` computation and returns the softmax regression values.
- Pass a custom set of RGB values to `agml.viz.set_colormap` to use a custom colormap.
- A new preprocessing function has been added to `agml.models.preprocessing`: `agml.models.preprocessing.imagenet_preprocess`, which prepares images for input to an ImageNet-backend model (image classification, semantic segmentation).

Bugfixes
- The `MeanAveragePrecision` metric has been fixed, and no longer throws errors for empty predictions (or for early-stage training results).
- Custom object detection datasets can now be auto-loaded and classes automatically inferred without throwing an error.

[*Read the Full Changelog Here.*](https://github.com/Project-AgML/AgML/compare/v0.4.4...v0.4.5)

This release introduces a number of updates and bugfixes.

Main Changes

`agml.synthetic`
- Helios compilation has now been optimized, meaning that canopy generation speed should be increased by 3 to 5 times.
- When using `HeliosOptions.camera.generate_positions()`, camera views are no longer angled by default.

`agml.models`
- The `agml.models.ClassificationModel` is now initialized with `num_classes`, rather than a `dataset` name.
- For the `agml.models.SegmentationModel.predict()` method, a new argument, `overlay`, has been added, which allows the resulting segmentation mask to be overlaid or displayed side-by-side.

`agml.viz`
- A new method has been added, `agml.viz.convert_figure_to_image()`, which converts the in-built Matplotlib figure when using `agml.viz` methods into an image array.

[*Read the Full Changelog Here*.](https://github.com/Project-AgML/AgML/compare/v0.4.3...v0.4.4)

This release contains additional bugfixes for Helios installation and compilation.

This release fixes installation problems when installing Helios.

Bugfixes

- Helios will now auto-install when running any configuration or compilation methods, rather than throwing an installation error.
- The installation script which fetches Helios is now correctly included with the package.

*Note*: AgML v0.4.1 contains a *partial* fix of these errors, so please use this version instead. This GitHub release collapses v0.4.1 and v0.4.2 into a single release.

This is the first release in the AgML v0.4.x cycle, introducing the `agml.synthetic` module backed by the Helios API (https://baileylab.ucdavis.edu/software/helios/) for generating synthetic agricultural data.

API Changes

`agml.synthetic`
- Introduction of the `agml.synthetic` module.
- Generate data using the `agml.synthetic.HeliosDataGenerator`.
- Customize generated data, including task, environment, and canopy parameters, using `agml.synthetic.HeliosOptions`.
- Convert data between the Helios and AgML formats automatically upon generation.
- Customize the compilation of Helios using `agml.synthetic.recompile_helios`.
- Get default parameters and information using `agml.synthetic.available_canopies()` and `agml.synthetic.default_canopy_parameters()`.

`agml.data`
- Load Helios-generated synthetic datasets using `agml.data.AgMLDataLoader.helios()`.

`agml.viz`
- Added new inspection methods for synthetic data:
- `agml.viz.plot_synthetic_camera_positions` creates a 3D plot from camera position and lookat vectors, to understand the geometry of the environment.
- `agml.viz.vizualize_all_views` plots all of the views for a specific generated canopy.

`agml.backend`
- Similar to the methods for public datasets and models, synthetic datasets can be generated to a specific path by using `agml.backend.set_synthetic_save_path()`, and retrieved using `agml.backend.synthetic_save_path()`.

[*Read The Full Changelog Here*](https://github.com/Project-AgML/AgML/compare/v0.3.0...v0.4.0)