Class HyperParameterTuningJobConfig
- java.lang.Object
-
- software.amazon.awssdk.services.sagemaker.model.HyperParameterTuningJobConfig
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<HyperParameterTuningJobConfig.Builder,HyperParameterTuningJobConfig>
@Generated("software.amazon.awssdk:codegen") public final class HyperParameterTuningJobConfig extends Object implements SdkPojo, Serializable, ToCopyableBuilder<HyperParameterTuningJobConfig.Builder,HyperParameterTuningJobConfig>
Configures a hyperparameter tuning job.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceHyperParameterTuningJobConfig.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static HyperParameterTuningJobConfig.Builderbuilder()booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()HyperParameterTuningJobObjectivehyperParameterTuningJobObjective()The HyperParameterTuningJobObjective specifies the objective metric used to evaluate the performance of training jobs launched by this tuning job.ParameterRangesparameterRanges()The ParameterRanges object that specifies the ranges of hyperparameters that this tuning job searches over to find the optimal configuration for the highest model performance against your chosen objective metric.IntegerrandomSeed()A value used to initialize a pseudo-random number generator.ResourceLimitsresourceLimits()The ResourceLimits object that specifies the maximum number of training and parallel training jobs that can be used for this hyperparameter tuning job.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends HyperParameterTuningJobConfig.Builder>serializableBuilderClass()HyperParameterTuningJobStrategyTypestrategy()Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches.StringstrategyAsString()Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches.HyperParameterTuningJobStrategyConfigstrategyConfig()The configuration for theHyperbandoptimization strategy.HyperParameterTuningJobConfig.BuildertoBuilder()StringtoString()Returns a string representation of this object.TrainingJobEarlyStoppingTypetrainingJobEarlyStoppingType()Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job.StringtrainingJobEarlyStoppingTypeAsString()Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job.TuningJobCompletionCriteriatuningJobCompletionCriteria()The tuning job's completion criteria.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
strategy
public final HyperParameterTuningJobStrategyType strategy()
Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches. For information about search strategies, see How Hyperparameter Tuning Works.
If the service returns an enum value that is not available in the current SDK version,
strategywill returnHyperParameterTuningJobStrategyType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstrategyAsString().- Returns:
- Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches. For information about search strategies, see How Hyperparameter Tuning Works.
- See Also:
HyperParameterTuningJobStrategyType
-
strategyAsString
public final String strategyAsString()
Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches. For information about search strategies, see How Hyperparameter Tuning Works.
If the service returns an enum value that is not available in the current SDK version,
strategywill returnHyperParameterTuningJobStrategyType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstrategyAsString().- Returns:
- Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches. For information about search strategies, see How Hyperparameter Tuning Works.
- See Also:
HyperParameterTuningJobStrategyType
-
strategyConfig
public final HyperParameterTuningJobStrategyConfig strategyConfig()
The configuration for the
Hyperbandoptimization strategy. This parameter should be provided only ifHyperbandis selected as the strategy forHyperParameterTuningJobConfig.- Returns:
- The configuration for the
Hyperbandoptimization strategy. This parameter should be provided only ifHyperbandis selected as the strategy forHyperParameterTuningJobConfig.
-
hyperParameterTuningJobObjective
public final HyperParameterTuningJobObjective hyperParameterTuningJobObjective()
The HyperParameterTuningJobObjective specifies the objective metric used to evaluate the performance of training jobs launched by this tuning job.
- Returns:
- The HyperParameterTuningJobObjective specifies the objective metric used to evaluate the performance of training jobs launched by this tuning job.
-
resourceLimits
public final ResourceLimits resourceLimits()
The ResourceLimits object that specifies the maximum number of training and parallel training jobs that can be used for this hyperparameter tuning job.
- Returns:
- The ResourceLimits object that specifies the maximum number of training and parallel training jobs that can be used for this hyperparameter tuning job.
-
parameterRanges
public final ParameterRanges parameterRanges()
The ParameterRanges object that specifies the ranges of hyperparameters that this tuning job searches over to find the optimal configuration for the highest model performance against your chosen objective metric.
- Returns:
- The ParameterRanges object that specifies the ranges of hyperparameters that this tuning job searches over to find the optimal configuration for the highest model performance against your chosen objective metric.
-
trainingJobEarlyStoppingType
public final TrainingJobEarlyStoppingType trainingJobEarlyStoppingType()
Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job. Because the
Hyperbandstrategy has its own advanced internal early stopping mechanism,TrainingJobEarlyStoppingTypemust beOFFto useHyperband. This parameter can take on one of the following values (the default value isOFF):- OFF
-
Training jobs launched by the hyperparameter tuning job do not use early stopping.
- AUTO
-
SageMaker stops training jobs launched by the hyperparameter tuning job when they are unlikely to perform better than previously completed training jobs. For more information, see Stop Training Jobs Early.
If the service returns an enum value that is not available in the current SDK version,
trainingJobEarlyStoppingTypewill returnTrainingJobEarlyStoppingType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtrainingJobEarlyStoppingTypeAsString().- Returns:
- Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job.
Because the
Hyperbandstrategy has its own advanced internal early stopping mechanism,TrainingJobEarlyStoppingTypemust beOFFto useHyperband. This parameter can take on one of the following values (the default value isOFF):- OFF
-
Training jobs launched by the hyperparameter tuning job do not use early stopping.
- AUTO
-
SageMaker stops training jobs launched by the hyperparameter tuning job when they are unlikely to perform better than previously completed training jobs. For more information, see Stop Training Jobs Early.
- See Also:
TrainingJobEarlyStoppingType
-
trainingJobEarlyStoppingTypeAsString
public final String trainingJobEarlyStoppingTypeAsString()
Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job. Because the
Hyperbandstrategy has its own advanced internal early stopping mechanism,TrainingJobEarlyStoppingTypemust beOFFto useHyperband. This parameter can take on one of the following values (the default value isOFF):- OFF
-
Training jobs launched by the hyperparameter tuning job do not use early stopping.
- AUTO
-
SageMaker stops training jobs launched by the hyperparameter tuning job when they are unlikely to perform better than previously completed training jobs. For more information, see Stop Training Jobs Early.
If the service returns an enum value that is not available in the current SDK version,
trainingJobEarlyStoppingTypewill returnTrainingJobEarlyStoppingType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtrainingJobEarlyStoppingTypeAsString().- Returns:
- Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job.
Because the
Hyperbandstrategy has its own advanced internal early stopping mechanism,TrainingJobEarlyStoppingTypemust beOFFto useHyperband. This parameter can take on one of the following values (the default value isOFF):- OFF
-
Training jobs launched by the hyperparameter tuning job do not use early stopping.
- AUTO
-
SageMaker stops training jobs launched by the hyperparameter tuning job when they are unlikely to perform better than previously completed training jobs. For more information, see Stop Training Jobs Early.
- See Also:
TrainingJobEarlyStoppingType
-
tuningJobCompletionCriteria
public final TuningJobCompletionCriteria tuningJobCompletionCriteria()
The tuning job's completion criteria.
- Returns:
- The tuning job's completion criteria.
-
randomSeed
public final Integer randomSeed()
A value used to initialize a pseudo-random number generator. Setting a random seed and using the same seed later for the same tuning job will allow hyperparameter optimization to find more a consistent hyperparameter configuration between the two runs.
- Returns:
- A value used to initialize a pseudo-random number generator. Setting a random seed and using the same seed later for the same tuning job will allow hyperparameter optimization to find more a consistent hyperparameter configuration between the two runs.
-
toBuilder
public HyperParameterTuningJobConfig.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<HyperParameterTuningJobConfig.Builder,HyperParameterTuningJobConfig>
-
builder
public static HyperParameterTuningJobConfig.Builder builder()
-
serializableBuilderClass
public static Class<? extends HyperParameterTuningJobConfig.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-