Minor updates

Changelog.md

@@ -0,0 +1,170 @@
+## 1.0.13
++ Added support for rotated ROI in `MLImageFeature.RegionOfInterest` method.
++ Added `MLModelData.FromFile` method to load ML model data from model files.
++ Added `MLImageFeature.TransformPoint` method for transforming detection points from feature space to image space.
++ Added `MLDepthFeature.TransformPoint` method for projecting 2D points into 3D space using depth.
++ Added `MLEdgeFeature.dataType` property for inspecting the data type of Edge features.
++ Added `MLAsyncPredictor` class for making predictions on a background thread.
++ Added `MLPredictorExtensions.ToAsync` extension method for converting predictor to an async predictor.
++ Improved prediction performance on Android devices with dedicated neural processing units.
++ Changed `MLEdgeFeature` class to `readonly struct` to prevent GC pressure.
++ Fixed `MLImageFeature` not respecting `AspectMode.AspectFit` when making predictions.
++ Fixed sporadic `NullReferenceException` when `MLModelData.FromHub` is called on some Android devices.
++ Updated `MLDepthFeature.Sample` method to accept a `Vector2` point instead of individual coordinates.
++ Removed `IMLCloudFeature` interface as it is no longer supported by the NatML Hub API.
++ Removed `MLCloudFeature` class as it is no longer supported by the NatML Hub API.
++ Removed `MLCloudModel` class as it is no longer supported by the NatML Hub API.
++ Removed `IMLAsyncPredictor` interface.
++ Removed `MLFeature.CloudType` utility method as it is no longer supported by the NatML Hub API.
++ Removed `MLArrayFeature` constructor that accepted an `MLCloudFeature`.
++ Removed `MLAudioFeature` constructor that accepted an `MLCloudFeature`.
++ Removed `MLImageFeature` constructor that accepted an `MLCloudFeature`.
++ Removed `MLImageFeature` constructor that accepted an encoded image `byte[]`.
++ Removed `MLImageFeature.Contiguous` method.
++ Removed `MLTextFeature` constructor that accepted an `MLCloudFeature`.
++ Removed `MLEdgeFeature.ReleaseFeature` method as it has long been deprecated.
+
+## 1.0.12
++ Upgraded to Hub 1.0.8.
+
+## 1.0.11
++ Added `MLModelDataEmbed` attribute for embedding model data at build time, making models immediately available in builds without downloads.
++ Added `MLImageFeature.NonMaxSuppression` method for performing non-maximum suppression on detection proposals.
++ Added `MLImageFeature.TransformRect` method for transforming detection rectangles from feature space to image space.
++ Added custom icon for identifying ML model files imported by NatML.
++ Migrated `MLPredictorExtensions.ToAsync` extension method and `MLAsyncPredictor` class to NatMLX.
++ Removed `MLPredictorExtensions.RectifyAspect` method. Use `MLImageFeature.TransformRect` method instead.
++ Removed `MLPredictorExtensions.NonMaxSuppression` method. Use `MLImageFeature.NonMaxSuppression` method instead.
++ Refactored top-level namespace from `NatSuite.ML` to `NatML` for parity with our other API's.
+
+## 1.0.10
++ Improved prediction performance on Windows systems with dedicated GPU's.
++ Added `MLArrayFeature` constructors that accept `NativeArray<T>` native arrays to minimize memory copies.
++ Added setter accessors to `MLArrayFeature` indexers allowing for writing values to feature data.
++ Added `MLAudioFeature.Contiguous` method for decoding encoded audio feature into memory.
++ Added support for creating greyscale image `MLEdgeFeature` features from `MLImageFeature` features.
++ Added `MLImageFeature.RegionOfInterest` method for extracting an ROI from an image.
++ Added `MLImageFeature.Contiguous` method for decoding encoded image feature into memory.
++ Added `MLDepthFeature.width` convenience property for getting width of depth features.
++ Added `MLDepthFeature.height` convenience property for getting height of depth features.
++ Added `MLImageType.interleaved` property for checking whether image feature is interleaved or planar.
++ Added `IMLCloudFeature` interface to create cloud ML features for making cloud predictions.
++ Added "Clear Predictor Cache" menu item for clearing predictor cache in the editor.
++ Added `NatMLHub.Subscribe` method for making subscription requests to the NatML API.
++ Fixed memory leak when using certain vision predictors like Robust Video Matting.
++ Refactored `MLHubModel` class to `MLCloudModel`.
++ Refactored `MLHubFeature` class to `MLCloudFeature`.
++ Refactored `HubDataType` class to `DataType`.
++ Deprecated `IMLHubFeature` interface.
++ Removed `MLAudioFeature.ReadToEnd` method. Use `MLAudioFeature.Contiguous` method instead.
+
+## 1.0.9
++ Added exclusive support for running CoreML graphs on iOS and macOS.
++ Added exclusive support for running TensorFlow Lite graphs on Android.
++ Added support for working with CoreML `.mlmodel` files in Unity projects.
++ Added support for working with TensorFlow Lite `.tflite` files in Unity projects.
++ Added support for Apple Silicon on macOS.
++ Added `MLVideoFeature` class for making ML predictions on video files.
++ Added `MLVideoType` feature type for inspecting video features.
++ Added `MLDepthFeature` abstract class for working with predictors that use depth data.
++ Added support for audio feature resampling in `MLAudioFeature` with `sampleRate` and `channelCount` fields.
++ Added `MLEdgeFeature` type for added type safety when authoring edge predictors.
++ Added `MLImageFeature` constructor which accepts a `NativeArray<byte>` pixel buffer.
++ Added `MLImageFeature.width` convenience property for getting width of image features.
++ Added `MLImageFeature.height` convenience property for getting height of image features.
++ Added `MLImageFeature.CopyTo` methods for copying pixel data from image feature.
++ Added `MLAudioFeature` constructor that accepts a `NativeArray<float>` to minimize memory copies.
++ Added `MLAudioFeature` path constructor for reading audio features from audio and video files.
++ Added `MLAudioFeature.CopyTo` methods for copying audio data from audio feature.
++ Added `MLAudioFeature.FromStreamingAssets` method for creating an audio feature from an audio file in the `StreamingAssets` folder. 
++ Added `MLAudioFeature.ToAudioClip` method for converting audio feature to an `AudioClip`.
++ Added `MLAudioFeature.ReadToEnd` method to read audio data into memory for audio features backed by an audio file.
++ Added `MLAudioType.FromFile` method for inspecting the audio type of a video or audio file.
++ Added `MLAudioType.FromAudioClip` method for inspecting the audio type of an audio clip.
++ Added `MLAudioType.FromVideoClip` method for inspecting the audio type of a video clip.
++ Added `MLAudioType.FromStreamingAssets` method for inspecting the audio type of a video file in the `StreamingAssets` folder.
++ Added `MLImageType` constructor that accepts image `channels`.
++ Fixed `MLImageFeature` type incorrectly reporting 3 channels instead of 4.
++ Fixed `MLImageFeature` default normalization standard deviation having `0` for alpha channel.
++ Removed `IMLModel` interface as it has long been deprecated.
++ Removed `IMLFeature` interface as it has long been deprecated.
+
+## 1.0.8
++ Fixed `Cannot deserialize graph` exception when deserializing cached predictors.
++ Fixed `MLModelData` being cached for `DRAFT` predictors.
+
+## 1.0.7
++ Added `MLArrayFeature` constructor that accepts an `MLHubFeature` for working with Hub predictors.
++ Added `MLAudioFeature` constructor that accepts an `MLHubFeature` for working with Hub predictors.
++ Added `MLImageFeature` constructor that accepts an `MLHubFeature` for working with Hub predictors.
++ Added `MLTextFeature` constructor that accepts an `MLHubFeature` for working with Hub predictors.
++ Fixed `DirectoryNotFoundException` when loading cached `MLModelData` on iOS.
++ Removed prediction analytics reporting to NatML Hub, relieving network bandwidth pressure.
++ Removed `cache` flag in `MLModelData.FromHub` method.
+
+## 1.0.6
++ Introduced Hub Predictors, which make predictions using server-side processing on [NatML Hub](https://hub.natml.ai).
++ Added `MLHubModel` class for authoring predictors that make cloud-based predictions using NatML Hub.
++ Added `MLEdgeModel` class for authoring predictors that make edge (on-device) predictions.
++ Added `IMLHubFeature` interface for creating server-side features when making predictions with NatML Hub.
++ Added `IMLEdgeFeature` interface for creating native features when making edge (on-device) predictions.
++ Added `MLTextType` feature type for inspecting `MLTextFeature` features.
++ Added `MLModelData.tag` property to identify the predictor tag from [NatML Hub](https://hub.natml.ai).
++ Added `MLModel.metadata` dictionary for inspecting model metadata.
++ Added `MLArrayFeature.Squeeze` to remove singleton dimensions from an array feature.
++ Added `MLArrayFeature.Flatten` to flatten an array feature into one-dimensional array feature.
++ Added `MLArrayFeature.ToArray` to convert an array feature into a flattened primitive array.
++ Added `MLImageFeature.ToTexture` to convert an image feature into a `Texture2D`.
++ Added `MLImageType.FromType` static method for converting arbitrary feature types to image types.
++ Added implicit conversion from `MLFeatureType` to `bool` indicating if the type is non-`null`.
++ Added implicit conversion from `MLTextFeature` to `string`.
++ Fixed `MLImageType` image resolution constructor assuming planar format instead of interleaved format.
++ Moved `IMLPredictor` interface to the top-level `NatSuite.ML` namespace.
++ Moved `IMLAsyncPredictor` interface to the top-level `NatSuite.ML` namespace.
++ Deprecated `IMLModel` interface. Cast model to `MLEdgeModel` class instead.
++ Deprecated `IMLFeature` interface. Cast feature to `IMLEdgeFeature` interface instead.
++ Deprecated `MLPredictorExtensions.GetImageSize` static method. Use `MLImageType.FromType` instead.
++ Removed `MLModelData.FromFile` method. Use [NatML Hub](https://hub.natml.ai) instead.
++ Removed `MLModelData.FromStreamingAssets` method. Use [NatML Hub](https://hub.natml.ai) instead.
++ Removed `MLPredictorExtensions.SerializeAudio` method.
++ Removed `MLPredictorExtensions.SerializeImage` method.
++ Removed `MLModel` dictionary indexers. Use `MLModel.metadata` property instead.
+
+## 1.0.5
++ Changed `MLImageFeature.mean` and `std` types to `Vector4` to support normalization for alpha channel.
++ Fixed bitcode not being generated for iOS `NatML.framework`.
++ Removed metadata accessors from `IMLModel` interface. Cast to `MLModel` instead.
+
+## 1.0.4
++ Greatly improved performance and memory pressure when performing multi-indexing with `MLArrayFeature<T>`.
++ Added `MLPredictorExtensions.RectifyAspect` extension method for correcting detection rects from aspect-scaled images.
++ Fixed crash when making predictions with recurrent models on previous state features.
++ Fixed crash when getting native array feature shape for `MLArrayFeature<T>`.
++ Fixed memory leak when making predictions with image features on iOS and macOS.
+
+## 1.0.3
++ Added `IMLAsyncPredictor` interface for making server-side ML predictions with NatML Hub.
++ Added `MLArrayFeature<T>` constructor which accepts a native array feature for easy interop.
++ Added multi-indexing support to `MLArrayFeature<T>` for post-processing native array features.
++ Added `MLArrayType.elementCount` property to get the total number of elements for an array type.
++ Added `MLArrayFeature<T>.shape` property which returns the feature type's shape for convenience.
++ Added `MLArrayFeature<T>.elementCount` property which returns the feature type's element count for convenience.
++ Added `MLArrayFeature<T>.CopyTo` method to copy feature data into an array.
++ Added `MLArrayFeature<T>.Permute` method to create a shallow array view with permuted dimensions.
++ Added `MLArrayFeature<T>.View` method to create a shallow array view with a different shape.
++ Added `MLPredictorExtensions.NonMaxSuppression` method for working with detection models.
++ Added `MLPredictorExtensions.GetImageSize` method for making predictions with image features.
++ Added `MLPredictorExtensions.SerializeAudio` method for making Hub predictions with audio features.
++ Added `MLPredictorExtensions.SerializeImage` method for making Hub predictions with image features.
++ Fixed `MLAsyncPredictor` predictions never completing if backing predictor encountered exception.
+
+## 1.0.2
++ Added `MLModelData.audioFormat` property for working with audio and speech ML models.
++ Added `MLTextFeature` for working with natural language processing models.
++ Added NatML menu items for fetching access key, viewing models, and more.
++ Exposed `mean` and `std` arrays in `MLModelData.Normalization` struct for models that require arbitrary normalization.
++ Removed generic `MLClassificationPredictor` and `MLDenseClassificationPredictor` predictors.
++ Removed ability to specify class labels for local `.onnx` file in project. Use NatML Hub instead.
+
+## 1.0.0
++ First release.

Editor/Importers/CoreMLImporter.cs

@@ -0,0 +1,26 @@
+/* 
+*   NatML
+*   Copyright (c) 2022 NatML Inc. All rights reserved.
+*/
+
+namespace NatML.Editor.Importers {
+
+    using Hub;
+
+    #if UNITY_2020_2_OR_NEWER
+    using UnityEditor.AssetImporters;
+    #else
+    using UnityEditor.Experimental.AssetImporters;
+    #endif
+
+    [ScriptedImporter(1, @"mlmodel")]
+    internal sealed class CoreMLImporter : GraphImporter {
+
+        protected override Session CreateSession (string graphPath) => new Session {
+            predictor = new Predictor {
+                status = PredictorStatus.Draft
+            },
+            format = GraphFormat.CoreML
+        };
+    }
+}

Editor/Importers/GraphImporter.cs

@@ -0,0 +1,30 @@
+/* 
+*   NatML
+*   Copyright (c) 2022 NatML Inc. All rights reserved.
+*/
+
+namespace NatML.Editor.Importers {
+
+    using System.IO;
+    using UnityEngine;
+    using Hub;
+
+    #if UNITY_2020_2_OR_NEWER
+    using UnityEditor.AssetImporters;
+    #else
+    using UnityEditor.Experimental.AssetImporters;
+    #endif
+
+    public abstract class GraphImporter : ScriptedImporter {
+
+        public sealed override void OnImportAsset (AssetImportContext ctx) {
+            var modelData = ScriptableObject.CreateInstance<MLModelData>();
+            modelData.session = CreateSession(ctx.assetPath);
+            modelData.graph = File.ReadAllBytes(ctx.assetPath);
+            ctx.AddObjectToAsset("MLModelData", modelData);
+            ctx.SetMainObject(modelData);
+        }
+
+        protected abstract Session CreateSession (string graphPath);
+    }
+}

Editor/Importers/ONNXImporter.cs

@@ -0,0 +1,26 @@
+/* 
+*   NatML
+*   Copyright (c) 2022 NatML Inc. All rights reserved.
+*/
+
+namespace NatML.Editor.Importers {
+
+    using Hub;
+
+    #if UNITY_2020_2_OR_NEWER
+    using UnityEditor.AssetImporters;
+    #else
+    using UnityEditor.Experimental.AssetImporters;
+    #endif
+
+    [ScriptedImporter(1, @"onnx")]
+    internal sealed class ONNXImporter : GraphImporter {
+
+        protected override Session CreateSession (string graphPath) => new Session {
+            predictor = new Predictor {
+                status = PredictorStatus.Draft
+            },
+            format = GraphFormat.ONNX
+        };
+    }
+}

Editor/Importers/TFLiteImporter.cs

@@ -0,0 +1,26 @@
+/* 
+*   NatML
+*   Copyright (c) 2022 NatML Inc. All rights reserved.
+*/
+
+namespace NatML.Editor.Importers {
+
+    using Hub;
+
+    #if UNITY_2020_2_OR_NEWER
+    using UnityEditor.AssetImporters;
+    #else
+    using UnityEditor.Experimental.AssetImporters;
+    #endif
+
+    [ScriptedImporter(1, @"tflite")]
+    internal sealed class TFLiteImporter : GraphImporter {
+
+        protected override Session CreateSession (string graphPath) => new Session {
+            predictor = new Predictor {
+                status = PredictorStatus.Draft
+            },
+            format = GraphFormat.TensorFlowLite
+        };
+    }
+}

Editor/NatML.ML.Editor.asmdef

@@ -0,0 +1,19 @@
+{
+    "name": "NatML.ML.Editor",
+    "references": [
+        "NatML.Hub",
+        "NatML.Hub.Editor",
+        "NatML.ML"
+    ],
+    "includePlatforms": [
+        "Editor"
+    ],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "precompiledReferences": [],
+    "autoReferenced": true,
+    "defineConstraints": [],
+    "versionDefines": [],
+    "noEngineReferences": false
+}