optuna.distributions.DiscreteUniformDistribution¶
- class optuna.distributions.DiscreteUniformDistribution(low: float, high: float, q: float)[source]¶
A discretized uniform distribution in the linear domain.
This object is instantiated by
suggest_discrete_uniform()
, and passed tosamplers
in general.Note
If the range \([\mathsf{low}, \mathsf{high}]\) is not divisible by \(q\), \(\mathsf{high}\) will be replaced with the maximum of \(k q + \mathsf{low} \lt \mathsf{high}\), where \(k\) is an integer.
- low¶
Lower endpoint of the range of the distribution.
low
is included in the range.
- high¶
Upper endpoint of the range of the distribution.
high
is included in the range.
- q¶
A discretization step.
Methods
__init__
(low, high, q)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) Any ¶
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: Any) float ¶
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.