optuna.distributions.CategoricalDistribution¶
- class optuna.distributions.CategoricalDistribution(choices: Sequence[Union[None, bool, int, float, str]])[source]¶
A categorical distribution.
This object is instantiated by
suggest_categorical()
, and passed tosamplers
in general.- Parameters
choices – Parameter value candidates.
Note
Not all types are guaranteed to be compatible with all storages. It is recommended to restrict the types of the choices to
None
,bool
,int
,float
andstr
.- choices¶
Parameter value candidates.
Methods
__init__
(choices)single
()Test whether the range of this distribution contains just a single value.
to_external_repr
(param_value_in_internal_repr)Convert internal representation of a parameter value into external representation.
to_internal_repr
(param_value_in_external_repr)Convert external representation of a parameter value into internal representation.
- single() bool [source]¶
Test whether the range of this distribution contains just a single value.
When this method returns
True
,samplers
always sample the same value from the distribution.
- to_external_repr(param_value_in_internal_repr: float) Union[None, bool, int, float, str] [source]¶
Convert internal representation of a parameter value into external representation.
- Parameters
param_value_in_internal_repr – Optuna’s internal representation of a parameter value.
- Returns
Optuna’s external representation of a parameter value.
- to_internal_repr(param_value_in_external_repr: Union[None, bool, int, float, str]) float [source]¶
Convert external representation of a parameter value into internal representation.
- Parameters
param_value_in_external_repr – Optuna’s external representation of a parameter value.
- Returns
Optuna’s internal representation of a parameter value.