aws-sdk-lookoutforvision 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b85b666e9666266e00f26ee190f05ed419d177d77ba8cadd49783bc4230826f
-  data.tar.gz: 7d7434eebc074e2499b98be6afec242c742df7f3ecac18d89314d49f61600f6d
+  metadata.gz: bdebeabc78919f184d949a7da75c25dd7c06fe6a33c0d7be57925218bceb3d01
+  data.tar.gz: 6691af3d7122199c1f341e9f37fa8569c5dbe1c5fb0523af8e30d35e28345b0c
 SHA512:
-  metadata.gz: 7ec0fd5d4c30059ae040d407e6040a22603c3a6b64591912a913590e592c458c149f6bc95f8bf00f05496fa1e4d70c3f099b208a1b0d4d10e5a3d7aa4c7bec90
-  data.tar.gz: 067b2b61f02d4d04e923be0a1060b371ed2d67dee0d9e56338805d0570979429357616b370ecce45d95160658ebdbb72f39162a3a149c40d9a6e43cabd2228b9
+  metadata.gz: f1b5a344a90ef50fade4a9386659ed7d31942ba60c840a117ca9fd81ce87f33fb8d3a4d0f8388f5d7cca17c647002824581acaa56e6eee8fc50a42a856bf1ccd
+  data.tar.gz: d014f245503da8775b4f60012cf48d3f855970b3910fd2259f4f3e9cd8bfcaa7aaaccd94e20e2e57cd9415a8ab55d64fd1a2d2a72a72b9f2fb0512b96e63047c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.16.0 (2022-07-28)
+------------------
+
+* Feature - This release introduces support for image segmentation models and updates CPU accelerator options for models hosted on edge devices.
+
 1.15.0 (2022-07-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.15.0
+1.16.0

data/lib/aws-sdk-lookoutforvision/client.rb

@@ -1002,7 +1002,9 @@ module Aws::LookoutforVision
     #
     # The response from `DetectAnomalies` includes a boolean prediction that
     # the image contains one or more anomalies and a confidence value for
-    # the prediction.
+    # the prediction. If the model is an image segmentation model, the
+    # response also includes segmentation information for each type of
+    # anomaly found in the image.
     #
     # <note markdown="1"> Before calling `DetectAnomalies`, you must first start your model with
     # the StartModel operation. You are charged for the amount of time, in
@@ -1012,6 +1014,9 @@ module Aws::LookoutforVision
     #
     #  </note>
     #
+    # For more information, see *Detecting anomalies in an image* in the
+    # Amazon Lookout for Vision developer guide.
+    #
     # This operation requires permissions to perform the
     # `lookoutvision:DetectAnomalies` operation.
     #
@@ -1047,6 +1052,11 @@ module Aws::LookoutforVision
     #   resp.detect_anomaly_result.source.type #=> String
     #   resp.detect_anomaly_result.is_anomalous #=> Boolean
     #   resp.detect_anomaly_result.confidence #=> Float
+    #   resp.detect_anomaly_result.anomalies #=> Array
+    #   resp.detect_anomaly_result.anomalies[0].name #=> String
+    #   resp.detect_anomaly_result.anomalies[0].pixel_anomaly.total_percentage_area #=> Float
+    #   resp.detect_anomaly_result.anomalies[0].pixel_anomaly.color #=> String
+    #   resp.detect_anomaly_result.anomaly_mask #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/DetectAnomalies AWS API Documentation
     #
@@ -1529,7 +1539,7 @@ module Aws::LookoutforVision
     #         target_platform: {
     #           os: "LINUX", # required, accepts LINUX
     #           arch: "ARM64", # required, accepts ARM64, X86_64
-    #           accelerator: "NVIDIA", # required, accepts NVIDIA
+    #           accelerator: "NVIDIA", # accepts NVIDIA
     #         },
     #         s3_output_location: { # required
     #           bucket: "S3BucketName", # required
@@ -1786,7 +1796,7 @@ module Aws::LookoutforVision
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-lookoutforvision'
-      context[:gem_version] = '1.15.0'
+      context[:gem_version] = '1.16.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-lookoutforvision/client_api.rb

@@ -14,9 +14,14 @@ module Aws::LookoutforVision
     include Seahorse::Model
 
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
+    Anomaly = Shapes::StructureShape.new(name: 'Anomaly')
     AnomalyClassFilter = Shapes::StringShape.new(name: 'AnomalyClassFilter')
+    AnomalyList = Shapes::ListShape.new(name: 'AnomalyList')
+    AnomalyMask = Shapes::BlobShape.new(name: 'AnomalyMask')
+    AnomalyName = Shapes::StringShape.new(name: 'AnomalyName')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     ClientToken = Shapes::StringShape.new(name: 'ClientToken')
+    Color = Shapes::StringShape.new(name: 'Color')
     CompilerOptions = Shapes::StringShape.new(name: 'CompilerOptions')
     ComponentDescription = Shapes::StringShape.new(name: 'ComponentDescription')
     ComponentName = Shapes::StringShape.new(name: 'ComponentName')
@@ -107,6 +112,7 @@ module Aws::LookoutforVision
     OutputS3Object = Shapes::StructureShape.new(name: 'OutputS3Object')
     PageSize = Shapes::IntegerShape.new(name: 'PageSize')
     PaginationToken = Shapes::StringShape.new(name: 'PaginationToken')
+    PixelAnomaly = Shapes::StructureShape.new(name: 'PixelAnomaly')
     ProjectArn = Shapes::StringShape.new(name: 'ProjectArn')
     ProjectDescription = Shapes::StructureShape.new(name: 'ProjectDescription')
     ProjectMetadata = Shapes::StructureShape.new(name: 'ProjectMetadata')
@@ -152,6 +158,12 @@ module Aws::LookoutforVision
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionString, required: true, location_name: "Message"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
+    Anomaly.add_member(:name, Shapes::ShapeRef.new(shape: AnomalyName, location_name: "Name"))
+    Anomaly.add_member(:pixel_anomaly, Shapes::ShapeRef.new(shape: PixelAnomaly, location_name: "PixelAnomaly"))
+    Anomaly.struct_class = Types::Anomaly
+
+    AnomalyList.member = Shapes::ShapeRef.new(shape: Anomaly)
+
     ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionString, required: true, location_name: "Message"))
     ConflictException.add_member(:resource_id, Shapes::ShapeRef.new(shape: ExceptionString, required: true, location_name: "ResourceId"))
     ConflictException.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, required: true, location_name: "ResourceType"))
@@ -278,6 +290,8 @@ module Aws::LookoutforVision
     DetectAnomalyResult.add_member(:source, Shapes::ShapeRef.new(shape: ImageSource, location_name: "Source"))
     DetectAnomalyResult.add_member(:is_anomalous, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsAnomalous"))
     DetectAnomalyResult.add_member(:confidence, Shapes::ShapeRef.new(shape: Float, location_name: "Confidence"))
+    DetectAnomalyResult.add_member(:anomalies, Shapes::ShapeRef.new(shape: AnomalyList, location_name: "Anomalies"))
+    DetectAnomalyResult.add_member(:anomaly_mask, Shapes::ShapeRef.new(shape: AnomalyMask, location_name: "AnomalyMask"))
     DetectAnomalyResult.struct_class = Types::DetectAnomalyResult
 
     GreengrassConfiguration.add_member(:compiler_options, Shapes::ShapeRef.new(shape: CompilerOptions, location_name: "CompilerOptions"))
@@ -425,6 +439,10 @@ module Aws::LookoutforVision
     OutputS3Object.add_member(:key, Shapes::ShapeRef.new(shape: S3ObjectKey, required: true, location_name: "Key"))
     OutputS3Object.struct_class = Types::OutputS3Object
 
+    PixelAnomaly.add_member(:total_percentage_area, Shapes::ShapeRef.new(shape: Float, location_name: "TotalPercentageArea"))
+    PixelAnomaly.add_member(:color, Shapes::ShapeRef.new(shape: Color, location_name: "Color"))
+    PixelAnomaly.struct_class = Types::PixelAnomaly
+
     ProjectDescription.add_member(:project_arn, Shapes::ShapeRef.new(shape: ProjectArn, location_name: "ProjectArn"))
     ProjectDescription.add_member(:project_name, Shapes::ShapeRef.new(shape: ProjectName, location_name: "ProjectName"))
     ProjectDescription.add_member(:creation_timestamp, Shapes::ShapeRef.new(shape: DateTime, location_name: "CreationTimestamp"))
@@ -499,7 +517,7 @@ module Aws::LookoutforVision
 
     TargetPlatform.add_member(:os, Shapes::ShapeRef.new(shape: TargetPlatformOs, required: true, location_name: "Os"))
     TargetPlatform.add_member(:arch, Shapes::ShapeRef.new(shape: TargetPlatformArch, required: true, location_name: "Arch"))
-    TargetPlatform.add_member(:accelerator, Shapes::ShapeRef.new(shape: TargetPlatformAccelerator, required: true, location_name: "Accelerator"))
+    TargetPlatform.add_member(:accelerator, Shapes::ShapeRef.new(shape: TargetPlatformAccelerator, location_name: "Accelerator"))
     TargetPlatform.struct_class = Types::TargetPlatform
 
     ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionString, required: true, location_name: "Message"))

data/lib/aws-sdk-lookoutforvision/types.rb

@@ -23,6 +23,29 @@ module Aws::LookoutforVision
       include Aws::Structure
     end
 
+    # Information about an anomaly type found on an image by an image
+    # segmentation model. For more information, see DetectAnomalies.
+    #
+    # @!attribute [rw] name
+    #   The name of an anomaly type found in an image. `Name` maps to an
+    #   anomaly type in the training dataset, apart from the anomaly type
+    #   `background`. The service automatically inserts the `background`
+    #   anomaly type into the response from `DetectAnomalies`.
+    #   @return [String]
+    #
+    # @!attribute [rw] pixel_anomaly
+    #   Information about the pixel mask that covers an anomaly type.
+    #   @return [Types::PixelAnomaly]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/Anomaly AWS API Documentation
+    #
+    class Anomaly < Struct.new(
+      :name,
+      :pixel_anomaly)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The update or deletion of a resource caused an inconsistent state.
     #
     # @!attribute [rw] message
@@ -812,6 +835,12 @@ module Aws::LookoutforVision
     end
 
     # The prediction results from a call to DetectAnomalies.
+    # `DetectAnomalyResult` includes classification information for the
+    # prediction (`IsAnomalous` and `Confidence`). If the model you use is
+    # an image segementation model, `DetectAnomalyResult` also includes
+    # segmentation information (`Anomalies` and `AnomalyMask`).
+    # Classification information is calculated separately from segmentation
+    # information and you shouldn't assume a relationship between them.
     #
     # @!attribute [rw] source
     #   The source of the image that was analyzed. `direct` means that the
@@ -820,20 +849,51 @@ module Aws::LookoutforVision
     #   @return [Types::ImageSource]
     #
     # @!attribute [rw] is_anomalous
-    #   True if the image contains an anomaly, otherwise false.
+    #   True if Amazon Lookout for Vision classifies the image as containing
+    #   an anomaly, otherwise false.
     #   @return [Boolean]
     #
     # @!attribute [rw] confidence
-    #   The confidence that Amazon Lookout for Vision has in the accuracy of
-    #   the prediction.
+    #   The confidence that Lookout for Vision has in the accuracy of the
+    #   classification in `IsAnomalous`.
     #   @return [Float]
     #
+    # @!attribute [rw] anomalies
+    #   If the model is an image segmentation model, `Anomalies` contains a
+    #   list of anomaly types found in the image. There is one entry for
+    #   each type of anomaly found (even if multiple instances of an anomaly
+    #   type exist on the image). The first element in the list is always an
+    #   anomaly type representing the image background ('background') and
+    #   shouldn't be considered an anomaly. Amazon Lookout for Vision
+    #   automatically add the background anomaly type to the response, and
+    #   you don't need to declare a background anomaly type in your
+    #   dataset.
+    #
+    #   If the list has one entry ('background'), no anomalies were found
+    #   on the image.
+    #
+    #
+    #
+    #   An image classification model doesn't return an `Anomalies` list.
+    #   @return [Array<Types::Anomaly>]
+    #
+    # @!attribute [rw] anomaly_mask
+    #   If the model is an image segmentation model, `AnomalyMask` contains
+    #   pixel masks that covers all anomaly types found on the image. Each
+    #   anomaly type has a different mask color. To map a color to an
+    #   anomaly type, see the `color` field of the PixelAnomaly object.
+    #
+    #   An image classification model doesn't return an `Anomalies` list.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/DetectAnomalyResult AWS API Documentation
     #
     class DetectAnomalyResult < Struct.new(
       :source,
       :is_anomalous,
-      :confidence)
+      :confidence,
+      :anomalies,
+      :anomaly_mask)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -857,7 +917,7 @@ module Aws::LookoutforVision
     #         target_platform: {
     #           os: "LINUX", # required, accepts LINUX
     #           arch: "ARM64", # required, accepts ARM64, X86_64
-    #           accelerator: "NVIDIA", # required, accepts NVIDIA
+    #           accelerator: "NVIDIA", # accepts NVIDIA
     #         },
     #         s3_output_location: { # required
     #           bucket: "S3BucketName", # required
@@ -876,9 +936,9 @@ module Aws::LookoutforVision
     #
     # @!attribute [rw] compiler_options
     #   Additional compiler options for the Greengrass component. Currently,
-    #   only NVIDIA Graphics Processing Units (GPU) are supported. If you
-    #   specify `TargetPlatform`, you must specify `CompilerOptions`. If you
-    #   specify `TargetDevice`, don't specify `CompilerOptions`.
+    #   only NVIDIA Graphics Processing Units (GPU) and CPU accelerators are
+    #   supported. If you specify `TargetDevice`, don't specify
+    #   `CompilerOptions`.
     #
     #   For more information, see *Compiler options* in the Amazon Lookout
     #   for Vision Developer Guide.
@@ -1469,7 +1529,7 @@ module Aws::LookoutforVision
     #           target_platform: {
     #             os: "LINUX", # required, accepts LINUX
     #             arch: "ARM64", # required, accepts ARM64, X86_64
-    #             accelerator: "NVIDIA", # required, accepts NVIDIA
+    #             accelerator: "NVIDIA", # accepts NVIDIA
     #           },
     #           s3_output_location: { # required
     #             bucket: "S3BucketName", # required
@@ -1711,6 +1771,29 @@ module Aws::LookoutforVision
       include Aws::Structure
     end
 
+    # Information about the pixels in an anomaly mask. For more information,
+    # see Anomaly. `PixelAnomaly` is only returned by image segmentation
+    # models.
+    #
+    # @!attribute [rw] total_percentage_area
+    #   The percentage area of the image that the anomaly type covers.
+    #   @return [Float]
+    #
+    # @!attribute [rw] color
+    #   A hex color value for the mask that covers an anomaly type. Each
+    #   anomaly type has a different mask color. The color maps to the color
+    #   of the anomaly type used in the training dataset.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/PixelAnomaly AWS API Documentation
+    #
+    class PixelAnomaly < Struct.new(
+      :total_percentage_area,
+      :color)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describe an Amazon Lookout for Vision project. For more information,
     # see DescribeProject.
     #
@@ -1872,7 +1955,7 @@ module Aws::LookoutforVision
     #             target_platform: {
     #               os: "LINUX", # required, accepts LINUX
     #               arch: "ARM64", # required, accepts ARM64, X86_64
-    #               accelerator: "NVIDIA", # required, accepts NVIDIA
+    #               accelerator: "NVIDIA", # accepts NVIDIA
     #             },
     #             s3_output_location: { # required
     #               bucket: "S3BucketName", # required
@@ -2175,7 +2258,7 @@ module Aws::LookoutforVision
     #       {
     #         os: "LINUX", # required, accepts LINUX
     #         arch: "ARM64", # required, accepts ARM64, X86_64
-    #         accelerator: "NVIDIA", # required, accepts NVIDIA
+    #         accelerator: "NVIDIA", # accepts NVIDIA
     #       }
     #
     # @!attribute [rw] os
@@ -2190,10 +2273,20 @@ module Aws::LookoutforVision
     #   @return [String]
     #
     # @!attribute [rw] accelerator
-    #   The target accelerator for the model. NVIDIA (Nvidia graphics
-    #   processing unit) is the only accelerator that is currently
-    #   supported. You must also specify the `gpu-code`, `trt-ver`, and
-    #   `cuda-ver` compiler options.
+    #   The target accelerator for the model. Currently, Amazon Lookout for
+    #   Vision only supports NVIDIA (Nvidia graphics processing unit) and
+    #   CPU accelerators. If you specify NVIDIA as an accelerator, you must
+    #   also specify the `gpu-code`, `trt-ver`, and `cuda-ver` compiler
+    #   options. If you don't specify an accelerator, Lookout for Vision
+    #   uses the CPU for compilation and we highly recommend that you use
+    #   the GreengrassConfiguration$CompilerOptions field. For example, you
+    #   can use the following compiler options for CPU:
+    #
+    #   * `mcpu`\: CPU micro-architecture. For example, `\{'mcpu':
+    #     'skylake-avx512'\}`
+    #
+    #   * `mattr`\: CPU flags. For example, `\{'mattr': ['+neon',
+    #     '+vfpv4']\}`
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/TargetPlatform AWS API Documentation

data/lib/aws-sdk-lookoutforvision.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-lookoutforvision/customizations'
 # @!group service
 module Aws::LookoutforVision
 
-  GEM_VERSION = '1.15.0'
+  GEM_VERSION = '1.16.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-lookoutforvision
 version: !ruby/object:Gem::Version
-  version: 1.15.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-26 00:00:00.000000000 Z
+date: 2022-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core