Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class Trial.
A message representing a Trial. A Trial contains a unique set of Parameters that has been or will be evaluated, along with the objective metrics got by running the Trial.
Generated from protobuf message google.cloud.aiplatform.v1.Trial
Namespace
Google \ Cloud \ AIPlatform \ V1Methods
__construct
Constructor.
| Parameters | |
|---|---|
| Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ name |
string
Output only. Resource name of the Trial assigned by the service. |
↳ id |
string
Output only. The identifier of the Trial assigned by the service. |
↳ state |
int
Output only. The detailed state of the Trial. |
↳ parameters |
array<Trial\Parameter>
Output only. The parameters of the Trial. |
↳ final_measurement |
Measurement
Output only. The final measurement containing the objective value. |
↳ measurements |
array<Measurement>
Output only. A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_duration). These are used for early stopping computations. |
↳ start_time |
Google\Protobuf\Timestamp
Output only. Time when the Trial was started. |
↳ end_time |
Google\Protobuf\Timestamp
Output only. Time when the Trial's status changed to |
↳ client_id |
string
Output only. The identifier of the client that originally requested this Trial. Each client is identified by a unique client_id. When a client asks for a suggestion, Vertex AI Vizier will assign it a Trial. The client should evaluate the Trial, complete it, and report back to Vertex AI Vizier. If suggestion is asked again by same client_id before the Trial is completed, the same Trial will be returned. Multiple clients with different client_ids can ask for suggestions simultaneously, each of them will get their own Trial. |
↳ infeasible_reason |
string
Output only. A human readable string describing why the Trial is infeasible. This is set only if Trial state is |
↳ custom_job |
string
Output only. The CustomJob name linked to the Trial. It's set for a HyperparameterTuningJob's Trial. |
↳ web_access_uris |
array|Google\Protobuf\Internal\MapField
Output only. URIs for accessing interactive shells (one URI for each training node). Only available if this trial is part of a HyperparameterTuningJob and the job's trial_job_spec.enable_web_access field is |
getName
Output only. Resource name of the Trial assigned by the service.
| Returns | |
|---|---|
| Type | Description |
string |
|
setName
Output only. Resource name of the Trial assigned by the service.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getId
Output only. The identifier of the Trial assigned by the service.
| Returns | |
|---|---|
| Type | Description |
string |
|
setId
Output only. The identifier of the Trial assigned by the service.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getState
Output only. The detailed state of the Trial.
| Returns | |
|---|---|
| Type | Description |
int |
Enum of type State. |
setState
Output only. The detailed state of the Trial.
| Parameter | |
|---|---|
| Name | Description |
var |
int
Enum of type State. |
| Returns | |
|---|---|
| Type | Description |
$this |
|
getParameters
Output only. The parameters of the Trial.
| Returns | |
|---|---|
| Type | Description |
Google\Protobuf\RepeatedField<Trial\Parameter> |
|
setParameters
Output only. The parameters of the Trial.
| Parameter | |
|---|---|
| Name | Description |
var |
array<Trial\Parameter>
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getFinalMeasurement
Output only. The final measurement containing the objective value.
| Returns | |
|---|---|
| Type | Description |
Measurement|null |
|
hasFinalMeasurement
clearFinalMeasurement
setFinalMeasurement
Output only. The final measurement containing the objective value.
| Parameter | |
|---|---|
| Name | Description |
var |
Measurement
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getMeasurements
Output only. A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
| Returns | |
|---|---|
| Type | Description |
Google\Protobuf\RepeatedField<Measurement> |
|
setMeasurements
Output only. A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
| Parameter | |
|---|---|
| Name | Description |
var |
array<Measurement>
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getStartTime
Output only. Time when the Trial was started.
| Returns | |
|---|---|
| Type | Description |
Google\Protobuf\Timestamp|null |
|
hasStartTime
clearStartTime
setStartTime
Output only. Time when the Trial was started.
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Protobuf\Timestamp
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getEndTime
Output only. Time when the Trial's status changed to SUCCEEDED or
INFEASIBLE.
| Returns | |
|---|---|
| Type | Description |
Google\Protobuf\Timestamp|null |
|
hasEndTime
clearEndTime
setEndTime
Output only. Time when the Trial's status changed to SUCCEEDED or
INFEASIBLE.
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Protobuf\Timestamp
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getClientId
Output only. The identifier of the client that originally requested this Trial. Each client is identified by a unique client_id. When a client asks for a suggestion, Vertex AI Vizier will assign it a Trial. The client should evaluate the Trial, complete it, and report back to Vertex AI Vizier. If suggestion is asked again by same client_id before the Trial is completed, the same Trial will be returned. Multiple clients with different client_ids can ask for suggestions simultaneously, each of them will get their own Trial.
| Returns | |
|---|---|
| Type | Description |
string |
|
setClientId
Output only. The identifier of the client that originally requested this Trial. Each client is identified by a unique client_id. When a client asks for a suggestion, Vertex AI Vizier will assign it a Trial. The client should evaluate the Trial, complete it, and report back to Vertex AI Vizier. If suggestion is asked again by same client_id before the Trial is completed, the same Trial will be returned. Multiple clients with different client_ids can ask for suggestions simultaneously, each of them will get their own Trial.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getInfeasibleReason
Output only. A human readable string describing why the Trial is
infeasible. This is set only if Trial state is INFEASIBLE.
| Returns | |
|---|---|
| Type | Description |
string |
|
setInfeasibleReason
Output only. A human readable string describing why the Trial is
infeasible. This is set only if Trial state is INFEASIBLE.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getCustomJob
Output only. The CustomJob name linked to the Trial.
It's set for a HyperparameterTuningJob's Trial.
| Returns | |
|---|---|
| Type | Description |
string |
|
setCustomJob
Output only. The CustomJob name linked to the Trial.
It's set for a HyperparameterTuningJob's Trial.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getWebAccessUris
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a
HyperparameterTuningJob
and the job's
trial_job_spec.enable_web_access
field is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
| Returns | |
|---|---|
| Type | Description |
Google\Protobuf\Internal\MapField |
|
setWebAccessUris
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a
HyperparameterTuningJob
and the job's
trial_job_spec.enable_web_access
field is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
| Parameter | |
|---|---|
| Name | Description |
var |
array|Google\Protobuf\Internal\MapField
|
| Returns | |
|---|---|
| Type | Description |
$this |
|