Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="ml_v1.html">AI Platform Training & Prediction API</a> . <a href="ml_v1.projects.html">projects</a> . <a href="ml_v1.projects.locations.html">locations</a> . <a href="ml_v1.projects.locations.studies.html">studies</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="ml_v1.projects.locations.studies.trials.html">trials()</a></code> |
| 79 | </p> |
| 80 | <p class="firstline">Returns the trials Resource.</p> |
| 81 | |
| 82 | <p class="toc_element"> |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 83 | <code><a href="#close">close()</a></code></p> |
| 84 | <p class="firstline">Close httplib2 connections.</p> |
| 85 | <p class="toc_element"> |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 86 | <code><a href="#create">create(parent, body=None, studyId=None, x__xgafv=None)</a></code></p> |
| 87 | <p class="firstline">Creates a study.</p> |
| 88 | <p class="toc_element"> |
| 89 | <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p> |
| 90 | <p class="firstline">Deletes a study.</p> |
| 91 | <p class="toc_element"> |
| 92 | <code><a href="#get">get(name, x__xgafv=None)</a></code></p> |
| 93 | <p class="firstline">Gets a study.</p> |
| 94 | <p class="toc_element"> |
| 95 | <code><a href="#list">list(parent, x__xgafv=None)</a></code></p> |
| 96 | <p class="firstline">Lists all the studies in a region for an associated project.</p> |
| 97 | <h3>Method Details</h3> |
| 98 | <div class="method"> |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 99 | <code class="details" id="close">close()</code> |
| 100 | <pre>Close httplib2 connections.</pre> |
| 101 | </div> |
| 102 | |
| 103 | <div class="method"> |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 104 | <code class="details" id="create">create(parent, body=None, studyId=None, x__xgafv=None)</code> |
| 105 | <pre>Creates a study. |
| 106 | |
| 107 | Args: |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 108 | parent: string, Required. The project and location that the study belongs to. Format: projects/{project}/locations/{location} (required) |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 109 | body: object, The request body. |
| 110 | The object takes the form of: |
| 111 | |
| 112 | { # A message representing a Study. |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 113 | "createTime": "A String", # Output only. Time at which the study was created. |
| 114 | "studyConfig": { # Represents configuration of a study. # Required. Configuration of the study. |
| 115 | "automatedStoppingConfig": { # Configuration for Automated Early Stopping of Trials. If no implementation_config is set, automated early stopping will not be run. # Configuration for automated stopping of unpromising Trials. |
| 116 | "decayCurveStoppingConfig": { |
| 117 | "useElapsedTime": True or False, # If true, measurement.elapsed_time is used as the x-axis of each Trials Decay Curve. Otherwise, Measurement.steps will be used as the x-axis. |
| 118 | }, |
| 119 | "medianAutomatedStoppingConfig": { # The median automated stopping rule stops a pending trial if the trial's best objective_value is strictly below the median 'performance' of all completed trials reported up to the trial's last measurement. Currently, 'performance' refers to the running average of the objective values reported by the trial in each measurement. |
| 120 | "useElapsedTime": True or False, # If true, the median automated stopping rule applies to measurement.use_elapsed_time, which means the elapsed_time field of the current trial's latest measurement is used to compute the median objective value for each completed trial. |
| 121 | }, |
| 122 | }, |
| 123 | "algorithm": "A String", # The search algorithm specified for the study. |
| 124 | "parameters": [ # Required. The set of parameters to tune. |
| 125 | { # Represents a single parameter to optimize. |
| 126 | "parentCategoricalValues": { # Represents the spec to match categorical values from parent parameter. |
| 127 | "values": [ # Matches values of the parent parameter with type 'CATEGORICAL'. All values must exist in `categorical_value_spec` of parent parameter. |
| 128 | "A String", |
| 129 | ], |
| 130 | }, |
| 131 | "categoricalValueSpec": { # The value spec for a 'CATEGORICAL' parameter. |
| 132 | "values": [ # Must be specified if type is `CATEGORICAL`. The list of possible categories. |
| 133 | "A String", |
| 134 | ], |
| 135 | }, |
| 136 | "parentDiscreteValues": { # Represents the spec to match discrete values from parent parameter. |
| 137 | "values": [ # Matches values of the parent parameter with type 'DISCRETE'. All values must exist in `discrete_value_spec` of parent parameter. |
| 138 | 3.14, |
| 139 | ], |
| 140 | }, |
| 141 | "scaleType": "A String", # How the parameter should be scaled. Leave unset for categorical parameters. |
| 142 | "discreteValueSpec": { # The value spec for a 'DISCRETE' parameter. |
| 143 | "values": [ # Must be specified if type is `DISCRETE`. A list of feasible points. The list should be in strictly increasing order. For instance, this parameter might have possible settings of 1.5, 2.5, and 4.0. This list should not contain more than 1,000 values. |
| 144 | 3.14, |
| 145 | ], |
| 146 | }, |
| 147 | "integerValueSpec": { # The value spec for an 'INTEGER' parameter. |
| 148 | "maxValue": "A String", # Must be specified if type is `INTEGER`. Maximum value of the parameter. |
| 149 | "minValue": "A String", # Must be specified if type is `INTEGER`. Minimum value of the parameter. |
| 150 | }, |
| 151 | "doubleValueSpec": { # The value spec for a 'DOUBLE' parameter. |
| 152 | "maxValue": 3.14, # Must be specified if type is `DOUBLE`. Maximum value of the parameter. |
| 153 | "minValue": 3.14, # Must be specified if type is `DOUBLE`. Minimum value of the parameter. |
| 154 | }, |
| 155 | "type": "A String", # Required. The type of the parameter. |
| 156 | "childParameterSpecs": [ # A child node is active if the parameter's value matches the child node's matching_parent_values. If two items in child_parameter_specs have the same name, they must have disjoint matching_parent_values. |
| 157 | # Object with schema name: GoogleCloudMlV1_StudyConfig_ParameterSpec |
| 158 | ], |
| 159 | "parameter": "A String", # Required. The parameter name must be unique amongst all ParameterSpecs. |
| 160 | "parentIntValues": { # Represents the spec to match integer values from parent parameter. |
| 161 | "values": [ # Matches values of the parent parameter with type 'INTEGER'. All values must lie in `integer_value_spec` of parent parameter. |
| 162 | "A String", |
| 163 | ], |
| 164 | }, |
| 165 | }, |
| 166 | ], |
| 167 | "metrics": [ # Metric specs for the study. |
| 168 | { # Represents a metric to optimize. |
| 169 | "goal": "A String", # Required. The optimization goal of the metric. |
| 170 | "metric": "A String", # Required. The name of the metric. |
| 171 | }, |
| 172 | ], |
| 173 | }, |
| 174 | "state": "A String", # Output only. The detailed state of a study. |
| 175 | "name": "A String", # Output only. The name of a study. |
| 176 | "inactiveReason": "A String", # Output only. A human readable reason why the Study is inactive. This should be empty if a study is ACTIVE or COMPLETED. |
| 177 | } |
| 178 | |
| 179 | studyId: string, Required. The ID to use for the study, which will become the final component of the study's resource name. |
| 180 | x__xgafv: string, V1 error format. |
| 181 | Allowed values |
| 182 | 1 - v1 error format |
| 183 | 2 - v2 error format |
| 184 | |
| 185 | Returns: |
| 186 | An object of the form: |
| 187 | |
| 188 | { # A message representing a Study. |
| 189 | "createTime": "A String", # Output only. Time at which the study was created. |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 190 | "studyConfig": { # Represents configuration of a study. # Required. Configuration of the study. |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 191 | "automatedStoppingConfig": { # Configuration for Automated Early Stopping of Trials. If no implementation_config is set, automated early stopping will not be run. # Configuration for automated stopping of unpromising Trials. |
| 192 | "decayCurveStoppingConfig": { |
| 193 | "useElapsedTime": True or False, # If true, measurement.elapsed_time is used as the x-axis of each Trials Decay Curve. Otherwise, Measurement.steps will be used as the x-axis. |
Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 194 | }, |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 195 | "medianAutomatedStoppingConfig": { # The median automated stopping rule stops a pending trial if the trial's best objective_value is strictly below the median 'performance' of all completed trials reported up to the trial's last measurement. Currently, 'performance' refers to the running average of the objective values reported by the trial in each measurement. |
| 196 | "useElapsedTime": True or False, # If true, the median automated stopping rule applies to measurement.use_elapsed_time, which means the elapsed_time field of the current trial's latest measurement is used to compute the median objective value for each completed trial. |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 197 | }, |
Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 198 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 199 | "algorithm": "A String", # The search algorithm specified for the study. |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 200 | "parameters": [ # Required. The set of parameters to tune. |
| 201 | { # Represents a single parameter to optimize. |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 202 | "parentCategoricalValues": { # Represents the spec to match categorical values from parent parameter. |
| 203 | "values": [ # Matches values of the parent parameter with type 'CATEGORICAL'. All values must exist in `categorical_value_spec` of parent parameter. |
| 204 | "A String", |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 205 | ], |
| 206 | }, |
| 207 | "categoricalValueSpec": { # The value spec for a 'CATEGORICAL' parameter. |
| 208 | "values": [ # Must be specified if type is `CATEGORICAL`. The list of possible categories. |
| 209 | "A String", |
| 210 | ], |
| 211 | }, |
| 212 | "parentDiscreteValues": { # Represents the spec to match discrete values from parent parameter. |
| 213 | "values": [ # Matches values of the parent parameter with type 'DISCRETE'. All values must exist in `discrete_value_spec` of parent parameter. |
| 214 | 3.14, |
| 215 | ], |
| 216 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 217 | "scaleType": "A String", # How the parameter should be scaled. Leave unset for categorical parameters. |
| 218 | "discreteValueSpec": { # The value spec for a 'DISCRETE' parameter. |
| 219 | "values": [ # Must be specified if type is `DISCRETE`. A list of feasible points. The list should be in strictly increasing order. For instance, this parameter might have possible settings of 1.5, 2.5, and 4.0. This list should not contain more than 1,000 values. |
| 220 | 3.14, |
| 221 | ], |
| 222 | }, |
| 223 | "integerValueSpec": { # The value spec for an 'INTEGER' parameter. |
| 224 | "maxValue": "A String", # Must be specified if type is `INTEGER`. Maximum value of the parameter. |
| 225 | "minValue": "A String", # Must be specified if type is `INTEGER`. Minimum value of the parameter. |
| 226 | }, |
| 227 | "doubleValueSpec": { # The value spec for a 'DOUBLE' parameter. |
| 228 | "maxValue": 3.14, # Must be specified if type is `DOUBLE`. Maximum value of the parameter. |
| 229 | "minValue": 3.14, # Must be specified if type is `DOUBLE`. Minimum value of the parameter. |
| 230 | }, |
| 231 | "type": "A String", # Required. The type of the parameter. |
| 232 | "childParameterSpecs": [ # A child node is active if the parameter's value matches the child node's matching_parent_values. If two items in child_parameter_specs have the same name, they must have disjoint matching_parent_values. |
| 233 | # Object with schema name: GoogleCloudMlV1_StudyConfig_ParameterSpec |
| 234 | ], |
| 235 | "parameter": "A String", # Required. The parameter name must be unique amongst all ParameterSpecs. |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 236 | "parentIntValues": { # Represents the spec to match integer values from parent parameter. |
| 237 | "values": [ # Matches values of the parent parameter with type 'INTEGER'. All values must lie in `integer_value_spec` of parent parameter. |
| 238 | "A String", |
| 239 | ], |
| 240 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 241 | }, |
| 242 | ], |
| 243 | "metrics": [ # Metric specs for the study. |
| 244 | { # Represents a metric to optimize. |
| 245 | "goal": "A String", # Required. The optimization goal of the metric. |
| 246 | "metric": "A String", # Required. The name of the metric. |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 247 | }, |
| 248 | ], |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 249 | }, |
Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 250 | "state": "A String", # Output only. The detailed state of a study. |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 251 | "name": "A String", # Output only. The name of a study. |
| 252 | "inactiveReason": "A String", # Output only. A human readable reason why the Study is inactive. This should be empty if a study is ACTIVE or COMPLETED. |
| 253 | }</pre> |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 254 | </div> |
| 255 | |
| 256 | <div class="method"> |
| 257 | <code class="details" id="delete">delete(name, x__xgafv=None)</code> |
| 258 | <pre>Deletes a study. |
| 259 | |
| 260 | Args: |
| 261 | name: string, Required. The study name. (required) |
| 262 | x__xgafv: string, V1 error format. |
| 263 | Allowed values |
| 264 | 1 - v1 error format |
| 265 | 2 - v2 error format |
| 266 | |
| 267 | Returns: |
| 268 | An object of the form: |
| 269 | |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 270 | { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`. |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 271 | }</pre> |
| 272 | </div> |
| 273 | |
| 274 | <div class="method"> |
| 275 | <code class="details" id="get">get(name, x__xgafv=None)</code> |
| 276 | <pre>Gets a study. |
| 277 | |
| 278 | Args: |
| 279 | name: string, Required. The study name. (required) |
| 280 | x__xgafv: string, V1 error format. |
| 281 | Allowed values |
| 282 | 1 - v1 error format |
| 283 | 2 - v2 error format |
| 284 | |
| 285 | Returns: |
| 286 | An object of the form: |
| 287 | |
| 288 | { # A message representing a Study. |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 289 | "createTime": "A String", # Output only. Time at which the study was created. |
| 290 | "studyConfig": { # Represents configuration of a study. # Required. Configuration of the study. |
| 291 | "automatedStoppingConfig": { # Configuration for Automated Early Stopping of Trials. If no implementation_config is set, automated early stopping will not be run. # Configuration for automated stopping of unpromising Trials. |
| 292 | "decayCurveStoppingConfig": { |
| 293 | "useElapsedTime": True or False, # If true, measurement.elapsed_time is used as the x-axis of each Trials Decay Curve. Otherwise, Measurement.steps will be used as the x-axis. |
| 294 | }, |
| 295 | "medianAutomatedStoppingConfig": { # The median automated stopping rule stops a pending trial if the trial's best objective_value is strictly below the median 'performance' of all completed trials reported up to the trial's last measurement. Currently, 'performance' refers to the running average of the objective values reported by the trial in each measurement. |
| 296 | "useElapsedTime": True or False, # If true, the median automated stopping rule applies to measurement.use_elapsed_time, which means the elapsed_time field of the current trial's latest measurement is used to compute the median objective value for each completed trial. |
| 297 | }, |
| 298 | }, |
| 299 | "algorithm": "A String", # The search algorithm specified for the study. |
| 300 | "parameters": [ # Required. The set of parameters to tune. |
| 301 | { # Represents a single parameter to optimize. |
| 302 | "parentCategoricalValues": { # Represents the spec to match categorical values from parent parameter. |
| 303 | "values": [ # Matches values of the parent parameter with type 'CATEGORICAL'. All values must exist in `categorical_value_spec` of parent parameter. |
| 304 | "A String", |
| 305 | ], |
Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 306 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 307 | "categoricalValueSpec": { # The value spec for a 'CATEGORICAL' parameter. |
| 308 | "values": [ # Must be specified if type is `CATEGORICAL`. The list of possible categories. |
| 309 | "A String", |
| 310 | ], |
| 311 | }, |
| 312 | "parentDiscreteValues": { # Represents the spec to match discrete values from parent parameter. |
| 313 | "values": [ # Matches values of the parent parameter with type 'DISCRETE'. All values must exist in `discrete_value_spec` of parent parameter. |
| 314 | 3.14, |
| 315 | ], |
| 316 | }, |
| 317 | "scaleType": "A String", # How the parameter should be scaled. Leave unset for categorical parameters. |
| 318 | "discreteValueSpec": { # The value spec for a 'DISCRETE' parameter. |
| 319 | "values": [ # Must be specified if type is `DISCRETE`. A list of feasible points. The list should be in strictly increasing order. For instance, this parameter might have possible settings of 1.5, 2.5, and 4.0. This list should not contain more than 1,000 values. |
| 320 | 3.14, |
| 321 | ], |
| 322 | }, |
| 323 | "integerValueSpec": { # The value spec for an 'INTEGER' parameter. |
| 324 | "maxValue": "A String", # Must be specified if type is `INTEGER`. Maximum value of the parameter. |
| 325 | "minValue": "A String", # Must be specified if type is `INTEGER`. Minimum value of the parameter. |
| 326 | }, |
| 327 | "doubleValueSpec": { # The value spec for a 'DOUBLE' parameter. |
| 328 | "maxValue": 3.14, # Must be specified if type is `DOUBLE`. Maximum value of the parameter. |
| 329 | "minValue": 3.14, # Must be specified if type is `DOUBLE`. Minimum value of the parameter. |
| 330 | }, |
| 331 | "type": "A String", # Required. The type of the parameter. |
| 332 | "childParameterSpecs": [ # A child node is active if the parameter's value matches the child node's matching_parent_values. If two items in child_parameter_specs have the same name, they must have disjoint matching_parent_values. |
| 333 | # Object with schema name: GoogleCloudMlV1_StudyConfig_ParameterSpec |
| 334 | ], |
| 335 | "parameter": "A String", # Required. The parameter name must be unique amongst all ParameterSpecs. |
| 336 | "parentIntValues": { # Represents the spec to match integer values from parent parameter. |
| 337 | "values": [ # Matches values of the parent parameter with type 'INTEGER'. All values must lie in `integer_value_spec` of parent parameter. |
| 338 | "A String", |
| 339 | ], |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 340 | }, |
Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 341 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 342 | ], |
| 343 | "metrics": [ # Metric specs for the study. |
| 344 | { # Represents a metric to optimize. |
| 345 | "goal": "A String", # Required. The optimization goal of the metric. |
| 346 | "metric": "A String", # Required. The name of the metric. |
| 347 | }, |
| 348 | ], |
| 349 | }, |
| 350 | "state": "A String", # Output only. The detailed state of a study. |
| 351 | "name": "A String", # Output only. The name of a study. |
| 352 | "inactiveReason": "A String", # Output only. A human readable reason why the Study is inactive. This should be empty if a study is ACTIVE or COMPLETED. |
| 353 | }</pre> |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 354 | </div> |
| 355 | |
| 356 | <div class="method"> |
| 357 | <code class="details" id="list">list(parent, x__xgafv=None)</code> |
| 358 | <pre>Lists all the studies in a region for an associated project. |
| 359 | |
| 360 | Args: |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 361 | parent: string, Required. The project and location that the study belongs to. Format: projects/{project}/locations/{location} (required) |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 362 | x__xgafv: string, V1 error format. |
| 363 | Allowed values |
| 364 | 1 - v1 error format |
| 365 | 2 - v2 error format |
| 366 | |
| 367 | Returns: |
| 368 | An object of the form: |
| 369 | |
| 370 | { |
| 371 | "studies": [ # The studies associated with the project. |
| 372 | { # A message representing a Study. |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 373 | "createTime": "A String", # Output only. Time at which the study was created. |
| 374 | "studyConfig": { # Represents configuration of a study. # Required. Configuration of the study. |
| 375 | "automatedStoppingConfig": { # Configuration for Automated Early Stopping of Trials. If no implementation_config is set, automated early stopping will not be run. # Configuration for automated stopping of unpromising Trials. |
| 376 | "decayCurveStoppingConfig": { |
| 377 | "useElapsedTime": True or False, # If true, measurement.elapsed_time is used as the x-axis of each Trials Decay Curve. Otherwise, Measurement.steps will be used as the x-axis. |
| 378 | }, |
| 379 | "medianAutomatedStoppingConfig": { # The median automated stopping rule stops a pending trial if the trial's best objective_value is strictly below the median 'performance' of all completed trials reported up to the trial's last measurement. Currently, 'performance' refers to the running average of the objective values reported by the trial in each measurement. |
| 380 | "useElapsedTime": True or False, # If true, the median automated stopping rule applies to measurement.use_elapsed_time, which means the elapsed_time field of the current trial's latest measurement is used to compute the median objective value for each completed trial. |
| 381 | }, |
| 382 | }, |
| 383 | "algorithm": "A String", # The search algorithm specified for the study. |
| 384 | "parameters": [ # Required. The set of parameters to tune. |
| 385 | { # Represents a single parameter to optimize. |
| 386 | "parentCategoricalValues": { # Represents the spec to match categorical values from parent parameter. |
| 387 | "values": [ # Matches values of the parent parameter with type 'CATEGORICAL'. All values must exist in `categorical_value_spec` of parent parameter. |
| 388 | "A String", |
| 389 | ], |
Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 390 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 391 | "categoricalValueSpec": { # The value spec for a 'CATEGORICAL' parameter. |
| 392 | "values": [ # Must be specified if type is `CATEGORICAL`. The list of possible categories. |
| 393 | "A String", |
| 394 | ], |
| 395 | }, |
| 396 | "parentDiscreteValues": { # Represents the spec to match discrete values from parent parameter. |
| 397 | "values": [ # Matches values of the parent parameter with type 'DISCRETE'. All values must exist in `discrete_value_spec` of parent parameter. |
| 398 | 3.14, |
| 399 | ], |
| 400 | }, |
| 401 | "scaleType": "A String", # How the parameter should be scaled. Leave unset for categorical parameters. |
| 402 | "discreteValueSpec": { # The value spec for a 'DISCRETE' parameter. |
| 403 | "values": [ # Must be specified if type is `DISCRETE`. A list of feasible points. The list should be in strictly increasing order. For instance, this parameter might have possible settings of 1.5, 2.5, and 4.0. This list should not contain more than 1,000 values. |
| 404 | 3.14, |
| 405 | ], |
| 406 | }, |
| 407 | "integerValueSpec": { # The value spec for an 'INTEGER' parameter. |
| 408 | "maxValue": "A String", # Must be specified if type is `INTEGER`. Maximum value of the parameter. |
| 409 | "minValue": "A String", # Must be specified if type is `INTEGER`. Minimum value of the parameter. |
| 410 | }, |
| 411 | "doubleValueSpec": { # The value spec for a 'DOUBLE' parameter. |
| 412 | "maxValue": 3.14, # Must be specified if type is `DOUBLE`. Maximum value of the parameter. |
| 413 | "minValue": 3.14, # Must be specified if type is `DOUBLE`. Minimum value of the parameter. |
| 414 | }, |
| 415 | "type": "A String", # Required. The type of the parameter. |
| 416 | "childParameterSpecs": [ # A child node is active if the parameter's value matches the child node's matching_parent_values. If two items in child_parameter_specs have the same name, they must have disjoint matching_parent_values. |
| 417 | # Object with schema name: GoogleCloudMlV1_StudyConfig_ParameterSpec |
| 418 | ], |
| 419 | "parameter": "A String", # Required. The parameter name must be unique amongst all ParameterSpecs. |
| 420 | "parentIntValues": { # Represents the spec to match integer values from parent parameter. |
| 421 | "values": [ # Matches values of the parent parameter with type 'INTEGER'. All values must lie in `integer_value_spec` of parent parameter. |
| 422 | "A String", |
| 423 | ], |
Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 424 | }, |
Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 425 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 426 | ], |
| 427 | "metrics": [ # Metric specs for the study. |
| 428 | { # Represents a metric to optimize. |
| 429 | "goal": "A String", # Required. The optimization goal of the metric. |
| 430 | "metric": "A String", # Required. The name of the metric. |
| 431 | }, |
| 432 | ], |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 433 | }, |
Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 434 | "state": "A String", # Output only. The detailed state of a study. |
| 435 | "name": "A String", # Output only. The name of a study. |
| 436 | "inactiveReason": "A String", # Output only. A human readable reason why the Study is inactive. This should be empty if a study is ACTIVE or COMPLETED. |
| 437 | }, |
Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 438 | ], |
| 439 | }</pre> |
| 440 | </div> |
| 441 | |
| 442 | </body></html> |