/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.sagemaker.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.protocol.StructuredPojo; import com.amazonaws.protocol.ProtocolMarshaller; /** *
* Stores the configuration information for how a candidate is generated (optional). *
* * @see AWS API Documentation */ @Generated("com.amazonaws:aws-java-sdk-code-generator") public class AutoMLCandidateGenerationConfig implements Serializable, Cloneable, StructuredPojo { /** *
* A URL to the Amazon S3 data source containing selected features from the input data source to run an Autopilot
* job. You can input FeatureAttributeNames
(optional) in JSON format as shown below:
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can support
* numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
,..)
* should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the column keys
* should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in ["col1", "col2", ...]
* are case sensitive and should be a list of strings containing unique values that are a subset of the column names
* in the input data. The list of columns provided must not include the target column.
*
* Stores the configuration information for the selection of algorithms used to train the model candidates. *
*
* The list of available algorithms to choose from depends on the training mode set in
* AutoMLJobConfig.Mode
.
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
*
* When AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set and one
* only.
*
* If the list of algorithms provided as values for AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
*
* When AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the full
* set of algorithms for the given training mode.
*
* For the list of all algorithms per training mode, see * AutoMLAlgorithmConfig. *
** For more information on each algorithm, see the Algorithm support section in Autopilot developer guide. *
*/ private java.util.List
* A URL to the Amazon S3 data source containing selected features from the input data source to run an Autopilot
* job. You can input FeatureAttributeNames
(optional) in JSON format as shown below:
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can support
* numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
,..)
* should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the column keys
* should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in ["col1", "col2", ...]
* are case sensitive and should be a list of strings containing unique values that are a subset of the column names
* in the input data. The list of columns provided must not include the target column.
*
FeatureAttributeNames
(optional) in JSON format as shown below:
*
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can support
* numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
* ,..) should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the column
* keys should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in
* ["col1", "col2", ...]
are case sensitive and should be a list of strings containing unique
* values that are a subset of the column names in the input data. The list of columns provided must not
* include the target column.
*/
public void setFeatureSpecificationS3Uri(String featureSpecificationS3Uri) {
this.featureSpecificationS3Uri = featureSpecificationS3Uri;
}
/**
*
* A URL to the Amazon S3 data source containing selected features from the input data source to run an Autopilot
* job. You can input FeatureAttributeNames
(optional) in JSON format as shown below:
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can support
* numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
,..)
* should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the column keys
* should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in ["col1", "col2", ...]
* are case sensitive and should be a list of strings containing unique values that are a subset of the column names
* in the input data. The list of columns provided must not include the target column.
*
FeatureAttributeNames
(optional) in JSON format as shown below:
*
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can
* support numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
* ,..) should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the
* column keys should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in
* ["col1", "col2", ...]
are case sensitive and should be a list of strings containing unique
* values that are a subset of the column names in the input data. The list of columns provided must not
* include the target column.
*/
public String getFeatureSpecificationS3Uri() {
return this.featureSpecificationS3Uri;
}
/**
*
* A URL to the Amazon S3 data source containing selected features from the input data source to run an Autopilot
* job. You can input FeatureAttributeNames
(optional) in JSON format as shown below:
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can support
* numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
,..)
* should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the column keys
* should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in ["col1", "col2", ...]
* are case sensitive and should be a list of strings containing unique values that are a subset of the column names
* in the input data. The list of columns provided must not include the target column.
*
FeatureAttributeNames
(optional) in JSON format as shown below:
*
*
* { "FeatureAttributeNames":["col1", "col2", ...] }
.
*
* You can also specify the data type of the feature (optional) in the format shown below: *
*
* { "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }
*
* These column keys may not include the target column. *
*
* In ensembling mode, Autopilot only supports the following data types: numeric
,
* categorical
, text
, and datetime
. In HPO mode, Autopilot can support
* numeric
, categorical
, text
, datetime
, and
* sequence
.
*
* If only FeatureDataTypes
is provided, the column keys (col1
, col2
* ,..) should be a subset of the column names in the input data.
*
* If both FeatureDataTypes
and FeatureAttributeNames
are provided, then the column
* keys should be a subset of the column names provided in FeatureAttributeNames
.
*
* The key name FeatureAttributeNames
is fixed. The values listed in
* ["col1", "col2", ...]
are case sensitive and should be a list of strings containing unique
* values that are a subset of the column names in the input data. The list of columns provided must not
* include the target column.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public AutoMLCandidateGenerationConfig withFeatureSpecificationS3Uri(String featureSpecificationS3Uri) {
setFeatureSpecificationS3Uri(featureSpecificationS3Uri);
return this;
}
/**
*
* Stores the configuration information for the selection of algorithms used to train the model candidates. *
*
* The list of available algorithms to choose from depends on the training mode set in
* AutoMLJobConfig.Mode
.
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
*
* When AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set and one
* only.
*
* If the list of algorithms provided as values for AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
*
* When AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the full
* set of algorithms for the given training mode.
*
* For the list of all algorithms per training mode, see * AutoMLAlgorithmConfig. *
** For more information on each algorithm, see the Algorithm support section in Autopilot developer guide. *
* * @return Stores the configuration information for the selection of algorithms used to train the model * candidates. *
* The list of available algorithms to choose from depends on the training mode set in
* AutoMLJobConfig.Mode
.
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
*
* When AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set
* and one only.
*
* If the list of algorithms provided as values for AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
*
* When AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the
* full set of algorithms for the given training mode.
*
* For the list of all algorithms per training mode, see * AutoMLAlgorithmConfig. *
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
*/
public java.util.List
* Stores the configuration information for the selection of algorithms used to train the model candidates.
*
* The list of available algorithms to choose from depends on the training mode set in
*
*
* When
* If the list of algorithms provided as values for
* When
* For the list of all algorithms per training mode, see
* AutoMLAlgorithmConfig.
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
* AutoMLJobConfig.Mode
.
*
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
* AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set and one
* only.
* AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
* AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the full
* set of algorithms for the given training mode.
*
* The list of available algorithms to choose from depends on the training mode set in
* AutoMLJobConfig.Mode
.
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
*
* When AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set
* and one only.
*
* If the list of algorithms provided as values for AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
*
* When AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the
* full set of algorithms for the given training mode.
*
* For the list of all algorithms per training mode, see * AutoMLAlgorithmConfig. *
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
*/
public void setAlgorithmsConfig(java.util.Collection
* Stores the configuration information for the selection of algorithms used to train the model candidates.
*
* The list of available algorithms to choose from depends on the training mode set in
*
*
* When
* If the list of algorithms provided as values for
* When
* For the list of all algorithms per training mode, see
* AutoMLAlgorithmConfig.
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setAlgorithmsConfig(java.util.Collection)} or {@link #withAlgorithmsConfig(java.util.Collection)} if you
* want to override the existing values.
* AutoMLJobConfig.Mode
.
*
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
* AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set and one
* only.
* AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
* AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the full
* set of algorithms for the given training mode.
*
* The list of available algorithms to choose from depends on the training mode set in
* AutoMLJobConfig.Mode
.
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
*
* When AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set
* and one only.
*
* If the list of algorithms provided as values for AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
*
* When AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the
* full set of algorithms for the given training mode.
*
* For the list of all algorithms per training mode, see * AutoMLAlgorithmConfig. *
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public AutoMLCandidateGenerationConfig withAlgorithmsConfig(AutoMLAlgorithmConfig... algorithmsConfig) {
if (this.algorithmsConfig == null) {
setAlgorithmsConfig(new java.util.ArrayList
* Stores the configuration information for the selection of algorithms used to train the model candidates.
*
* The list of available algorithms to choose from depends on the training mode set in
*
*
* When
* If the list of algorithms provided as values for
* When
* For the list of all algorithms per training mode, see
* AutoMLAlgorithmConfig.
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
* AutoMLJobConfig.Mode
.
*
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
* AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set and one
* only.
* AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
* AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the full
* set of algorithms for the given training mode.
*
* The list of available algorithms to choose from depends on the training mode set in
* AutoMLJobConfig.Mode
.
*
* AlgorithmsConfig
should not be set in AUTO
training mode.
*
* When AlgorithmsConfig
is provided, one AutoMLAlgorithms
attribute must be set
* and one only.
*
* If the list of algorithms provided as values for AutoMLAlgorithms
is empty,
* AutoMLCandidateGenerationConfig
uses the full set of algorithms for the given training mode.
*
* When AlgorithmsConfig
is not provided, AutoMLCandidateGenerationConfig
uses the
* full set of algorithms for the given training mode.
*
* For the list of all algorithms per training mode, see * AutoMLAlgorithmConfig. *
*
* For more information on each algorithm, see the Algorithm support section in Autopilot developer guide.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public AutoMLCandidateGenerationConfig withAlgorithmsConfig(java.util.Collection