{
"cells": [
{
"cell_type": "markdown",
"id": "c931e650",
"metadata": {
"collapsed": true,
"customInput": null,
"originalKey": "ac61b043-8ebf-43b9-9fa5-ed9a42a184ce",
"papermill": {
"duration": 0.006766,
"end_time": "2024-05-13T05:18:53.582007",
"exception": false,
"start_time": "2024-05-13T05:18:53.575241",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"# Tune a CNN on MNIST\n",
"\n",
"This tutorial walks through using Ax to tune two hyperparameters (learning rate and momentum) for a PyTorch CNN on the MNIST dataset trained using SGD with momentum."
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "471b1a98",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:18:53.595708Z",
"iopub.status.busy": "2024-05-13T05:18:53.595213Z",
"iopub.status.idle": "2024-05-13T05:18:57.186492Z",
"shell.execute_reply": "2024-05-13T05:18:57.185667Z"
},
"executionStartTime": 1690415246079,
"executionStopTime": 1690415266324,
"originalKey": "c2b37f0f-3644-4367-912f-f775082f6676",
"papermill": {
"duration": 3.612065,
"end_time": "2024-05-13T05:18:57.200185",
"exception": false,
"start_time": "2024-05-13T05:18:53.588120",
"status": "completed"
},
"requestMsgId": "0b481630-f0f4-436a-a205-a25aa163a364",
"showInput": true,
"tags": []
},
"outputs": [
{
"data": {
"text/html": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:18:57] ax.utils.notebook.plotting: Injecting Plotly library into cell. Do not overwrite or delete cell.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:18:57] ax.utils.notebook.plotting: Please see\n",
" (https://ax.dev/tutorials/visualizations.html#Fix-for-plots-that-are-not-rendering)\n",
" if visualizations are not rendering.\n"
]
},
{
"data": {
"text/html": [
" \n",
" "
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import torch\n",
"\n",
"import torch.nn as nn\n",
"import torch.nn.functional as F\n",
"\n",
"from ax.service.ax_client import AxClient, ObjectiveProperties\n",
"from ax.service.utils.report_utils import exp_to_df\n",
"from ax.utils.notebook.plotting import init_notebook_plotting, render\n",
"from ax.utils.tutorials.cnn_utils import evaluate, load_mnist, train\n",
"from torch._tensor import Tensor\n",
"from torch.utils.data import DataLoader\n",
"\n",
"init_notebook_plotting()"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "f2a4eb05",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:18:57.273339Z",
"iopub.status.busy": "2024-05-13T05:18:57.273058Z",
"iopub.status.idle": "2024-05-13T05:18:57.277943Z",
"shell.execute_reply": "2024-05-13T05:18:57.277428Z"
},
"executionStartTime": 1690415266521,
"executionStopTime": 1690415266529,
"originalKey": "4d0a27c4-a6ce-4b7d-97eb-1c229aabb375",
"papermill": {
"duration": 0.042899,
"end_time": "2024-05-13T05:18:57.279183",
"exception": false,
"start_time": "2024-05-13T05:18:57.236284",
"status": "completed"
},
"requestMsgId": "fd975d25-a185-4b09-a50f-7b2bcd89f93f",
"showInput": true,
"tags": []
},
"outputs": [],
"source": [
"torch.manual_seed(42)\n",
"dtype = torch.float\n",
"device = torch.device(\"cuda\" if torch.cuda.is_available() else \"cpu\")"
]
},
{
"cell_type": "markdown",
"id": "d5f57409",
"metadata": {
"customInput": null,
"originalKey": "10384e51-444c-4265-b56d-ad078d05d2a1",
"papermill": {
"duration": 0.03555,
"end_time": "2024-05-13T05:18:57.350493",
"exception": false,
"start_time": "2024-05-13T05:18:57.314943",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"## 1. Load MNIST data\n",
"First, we need to load the MNIST data and partition it into training, validation, and test sets.\n",
"\n",
"Note: this will download the dataset if necessary."
]
},
{
"cell_type": "code",
"execution_count": 3,
"id": "0dc6f4e8",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:18:57.424675Z",
"iopub.status.busy": "2024-05-13T05:18:57.424073Z",
"iopub.status.idle": "2024-05-13T05:19:01.270896Z",
"shell.execute_reply": "2024-05-13T05:19:01.270106Z"
},
"executionStartTime": 1690415266733,
"executionStopTime": 1690415266902,
"originalKey": "6f0949e2-1064-44b8-99c0-f6ce23df7c63",
"papermill": {
"duration": 3.885159,
"end_time": "2024-05-13T05:19:01.272362",
"exception": false,
"start_time": "2024-05-13T05:18:57.387203",
"status": "completed"
},
"requestMsgId": "8ce7dd21-9afb-4379-ad11-4112b4d27f8a",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Downloading http://yann.lecun.com/exdb/mnist/train-images-idx3-ubyte.gz\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"Failed to download (trying next):\n",
"HTTP Error 403: Forbidden\n",
"\n",
"Downloading https://ossci-datasets.s3.amazonaws.com/mnist/train-images-idx3-ubyte.gz\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"Downloading https://ossci-datasets.s3.amazonaws.com/mnist/train-images-idx3-ubyte.gz to ./data/MNIST/raw/train-images-idx3-ubyte.gz\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"\r",
" 0%| | 0/9912422 [00:00= p2\" or \"p1 + p2 <= some_bound\".\n",
" # outcome_constraints: Optional, a list of strings of form \"constrained_metric <= some_bound\".\n",
")"
]
},
{
"cell_type": "markdown",
"id": "4af08b5d",
"metadata": {
"customInput": null,
"originalKey": "af441a83-50fd-4385-a380-d8ebc570c0e5",
"papermill": {
"duration": 0.036957,
"end_time": "2024-05-13T05:19:01.660047",
"exception": false,
"start_time": "2024-05-13T05:19:01.623090",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"## 4. Define how to evaluate trials\n"
]
},
{
"cell_type": "markdown",
"id": "e4056ff7",
"metadata": {
"customInput": null,
"originalKey": "c7630dfd-548b-408a-badf-b6abf79275e2",
"papermill": {
"duration": 0.037172,
"end_time": "2024-05-13T05:19:01.734135",
"exception": false,
"start_time": "2024-05-13T05:19:01.696963",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"First we define a simple CNN class to classify the MNIST images"
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "3a239db6",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:19:01.810557Z",
"iopub.status.busy": "2024-05-13T05:19:01.810017Z",
"iopub.status.idle": "2024-05-13T05:19:01.815449Z",
"shell.execute_reply": "2024-05-13T05:19:01.814788Z"
},
"executionStartTime": 1690415267282,
"executionStopTime": 1690415267286,
"originalKey": "e41fea0a-ae71-4e6f-8c0a-6eb6ae143fb0",
"papermill": {
"duration": 0.044872,
"end_time": "2024-05-13T05:19:01.816811",
"exception": false,
"start_time": "2024-05-13T05:19:01.771939",
"status": "completed"
},
"requestMsgId": "60f14ec9-eb1b-4e88-95c5-15c91f999c90",
"showInput": true,
"tags": []
},
"outputs": [],
"source": [
"class CNN(nn.Module):\n",
" \n",
" def __init__(self) -> None:\n",
" super().__init__()\n",
" self.conv1 = nn.Conv2d(1, 20, kernel_size=5, stride=1)\n",
" self.fc1 = nn.Linear(8 * 8 * 20, 64)\n",
" self.fc2 = nn.Linear(64, 10)\n",
"\n",
" def forward(self, x: Tensor) -> Tensor:\n",
" x = F.relu(self.conv1(x))\n",
" x = F.max_pool2d(x, 3, 3)\n",
" x = x.view(-1, 8 * 8 * 20)\n",
" x = F.relu(self.fc1(x))\n",
" x = self.fc2(x)\n",
" return F.log_softmax(x, dim=-1)"
]
},
{
"cell_type": "markdown",
"id": "99f51af6",
"metadata": {
"customInput": null,
"originalKey": "8ef6bcb9-c492-4874-b8c7-a07f7e6291ad",
"papermill": {
"duration": 0.036681,
"end_time": "2024-05-13T05:19:01.890660",
"exception": false,
"start_time": "2024-05-13T05:19:01.853979",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"In this tutorial, we want to optimize classification accuracy on the validation set as a function of the learning rate and momentum. The `train_evaluate` function takes in a parameterization (set of parameter values), computes the classification accuracy, and returns that metric. "
]
},
{
"cell_type": "code",
"execution_count": 7,
"id": "b9ce5a06",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:19:01.966535Z",
"iopub.status.busy": "2024-05-13T05:19:01.966008Z",
"iopub.status.idle": "2024-05-13T05:19:01.970185Z",
"shell.execute_reply": "2024-05-13T05:19:01.969552Z"
},
"executionStartTime": 1690415267388,
"executionStopTime": 1690415267395,
"originalKey": "a7e4bcc4-7494-429b-bb93-7ad84d0985af",
"papermill": {
"duration": 0.043923,
"end_time": "2024-05-13T05:19:01.971539",
"exception": false,
"start_time": "2024-05-13T05:19:01.927616",
"status": "completed"
},
"requestMsgId": "5d486dbf-60cb-453d-8f24-8605f974b0a7",
"showInput": true,
"tags": []
},
"outputs": [],
"source": [
"def train_evaluate(parameterization):\n",
" \"\"\"\n",
" Train the model and then compute an evaluation metric.\n",
"\n",
" In this tutorial, the CNN utils package is doing a lot of work\n",
" under the hood:\n",
" - `train` initializes the network, defines the loss function\n",
" and optimizer, performs the training loop, and returns the\n",
" trained model.\n",
" - `evaluate` computes the accuracy of the model on the\n",
" evaluation dataset and returns the metric.\n",
"\n",
" For your use case, you can define training and evaluation functions\n",
" of your choosing.\n",
"\n",
" \"\"\"\n",
" net = CNN()\n",
" net = train(\n",
" net=net,\n",
" train_loader=train_loader,\n",
" parameters=parameterization,\n",
" dtype=dtype,\n",
" device=device,\n",
" )\n",
"\n",
" return evaluate(\n",
" net=net, \n",
" data_loader=valid_loader, \n",
" dtype=dtype, \n",
" device=device,\n",
" )\n"
]
},
{
"cell_type": "markdown",
"id": "36ac195f",
"metadata": {
"customInput": null,
"originalKey": "9ab127a8-021f-4ec8-9f4e-f4256a2e322a",
"papermill": {
"duration": 0.037273,
"end_time": "2024-05-13T05:19:02.045963",
"exception": false,
"start_time": "2024-05-13T05:19:02.008690",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"## 5. Run optimization loop\n"
]
},
{
"cell_type": "markdown",
"id": "3975644e",
"metadata": {
"customInput": null,
"originalKey": "411a2fb4-e8a3-4414-bc17-09f0b5ba3e74",
"papermill": {
"duration": 0.037241,
"end_time": "2024-05-13T05:19:02.120455",
"exception": false,
"start_time": "2024-05-13T05:19:02.083214",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"First we use `attach_trial` to attach a custom trial with manually-chosen parameters. This step is optional, but we include it here to demonstrate adding manual trials and to serve as a baseline model with decent performance. "
]
},
{
"cell_type": "code",
"execution_count": 8,
"id": "7ad897b8",
"metadata": {
"customInput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:19:02.196173Z",
"iopub.status.busy": "2024-05-13T05:19:02.195892Z",
"iopub.status.idle": "2024-05-13T05:19:09.001699Z",
"shell.execute_reply": "2024-05-13T05:19:09.001062Z"
},
"executionStartTime": 1690415267533,
"executionStopTime": 1690415287786,
"originalKey": "1388ef55-5642-46ab-b297-c76a73a48aca",
"papermill": {
"duration": 6.845294,
"end_time": "2024-05-13T05:19:09.003062",
"exception": false,
"start_time": "2024-05-13T05:19:02.157768",
"status": "completed"
},
"requestMsgId": "b32a4981-ad59-46e1-b701-fa5a5f118d8b",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:02] ax.core.experiment: Attached custom parameterizations [{'lr': 2.6e-05, 'momentum': 0.58}] as trial 0.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:08] ax.service.ax_client: Completed trial 0 with data: {'accuracy': (0.841833, None)}.\n"
]
}
],
"source": [
"# Attach the trial\n",
"ax_client.attach_trial(\n",
" parameters={\"lr\": 0.000026, \"momentum\": 0.58}\n",
")\n",
"\n",
"# Get the parameters and run the trial \n",
"baseline_parameters = ax_client.get_trial_parameters(trial_index=0)\n",
"ax_client.complete_trial(trial_index=0, raw_data=train_evaluate(baseline_parameters))"
]
},
{
"cell_type": "markdown",
"id": "7081f3af",
"metadata": {
"customInput": null,
"originalKey": "f0f886a1-c5c8-44bb-b2fd-9fa3f140357a",
"papermill": {
"duration": 0.037163,
"end_time": "2024-05-13T05:19:09.077585",
"exception": false,
"start_time": "2024-05-13T05:19:09.040422",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"Now we start the optimization loop.\n",
"\n",
"At each step, the user queries the client for a new trial then submits the evaluation of that trial back to the client.\n",
"\n",
"Note that Ax auto-selects an appropriate optimization algorithm based on the search space. For more advanced use cases that require a specific optimization algorithm, pass a `generation_strategy` argument into the `AxClient` constructor. Note that when Bayesian Optimization is used, generating new trials may take a few minutes."
]
},
{
"cell_type": "code",
"execution_count": 9,
"id": "8561f3a0",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:19:09.153556Z",
"iopub.status.busy": "2024-05-13T05:19:09.152960Z",
"iopub.status.idle": "2024-05-13T05:22:11.110448Z",
"shell.execute_reply": "2024-05-13T05:22:11.109846Z"
},
"executionStartTime": 1690415287908,
"executionStopTime": 1690415945107,
"originalKey": "bff5d714-1ab3-43d3-b9b3-8c3a53c81dcb",
"papermill": {
"duration": 181.99706,
"end_time": "2024-05-13T05:22:11.111776",
"exception": false,
"start_time": "2024-05-13T05:19:09.114716",
"status": "completed"
},
"requestMsgId": "a203534f-85dd-4dfa-9fa6-6aa46a0200a3",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:09] ax.service.ax_client: Generated new trial 1 with parameters {'lr': 0.009955, 'momentum': 0.633423} using model Sobol.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:15] ax.service.ax_client: Completed trial 1 with data: {'accuracy': (0.100333, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:15] ax.service.ax_client: Generated new trial 2 with parameters {'lr': 5e-06, 'momentum': 0.022851} using model Sobol.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:22] ax.service.ax_client: Completed trial 2 with data: {'accuracy': (0.318667, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:22] ax.service.ax_client: Generated new trial 3 with parameters {'lr': 7e-06, 'momentum': 0.176948} using model Sobol.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:29] ax.service.ax_client: Completed trial 3 with data: {'accuracy': (0.4585, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:29] ax.service.ax_client: Generated new trial 4 with parameters {'lr': 8.2e-05, 'momentum': 0.90883} using model Sobol.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:36] ax.service.ax_client: Completed trial 4 with data: {'accuracy': (0.926, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:36] ax.service.ax_client: Generated new trial 5 with parameters {'lr': 0.000302, 'momentum': 0.341904} using model Sobol.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:43] ax.service.ax_client: Completed trial 5 with data: {'accuracy': (0.929, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:43] ax.service.ax_client: Generated new trial 6 with parameters {'lr': 0.000137, 'momentum': 0.590917} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:50] ax.service.ax_client: Completed trial 6 with data: {'accuracy': (0.92, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:50] ax.service.ax_client: Generated new trial 7 with parameters {'lr': 1e-05, 'momentum': 1.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:57] ax.service.ax_client: Completed trial 7 with data: {'accuracy': (0.860167, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:19:57] ax.service.ax_client: Generated new trial 8 with parameters {'lr': 0.000246, 'momentum': 0.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:04] ax.service.ax_client: Completed trial 8 with data: {'accuracy': (0.888833, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:05] ax.service.ax_client: Generated new trial 9 with parameters {'lr': 0.000149, 'momentum': 0.286357} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:11] ax.service.ax_client: Completed trial 9 with data: {'accuracy': (0.901667, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:12] ax.service.ax_client: Generated new trial 10 with parameters {'lr': 1e-06, 'momentum': 1.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:19] ax.service.ax_client: Completed trial 10 with data: {'accuracy': (0.560333, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:19] ax.service.ax_client: Generated new trial 11 with parameters {'lr': 3.7e-05, 'momentum': 1.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:26] ax.service.ax_client: Completed trial 11 with data: {'accuracy': (0.759167, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:27] ax.service.ax_client: Generated new trial 12 with parameters {'lr': 0.000261, 'momentum': 0.91355} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:34] ax.service.ax_client: Completed trial 12 with data: {'accuracy': (0.945333, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:35] ax.service.ax_client: Generated new trial 13 with parameters {'lr': 0.00017, 'momentum': 0.799113} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:41] ax.service.ax_client: Completed trial 13 with data: {'accuracy': (0.942833, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:42] ax.service.ax_client: Generated new trial 14 with parameters {'lr': 0.000159, 'momentum': 1.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:49] ax.service.ax_client: Completed trial 14 with data: {'accuracy': (0.842833, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:49] ax.service.ax_client: Generated new trial 15 with parameters {'lr': 0.000311, 'momentum': 0.665002} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:56] ax.service.ax_client: Completed trial 15 with data: {'accuracy': (0.945833, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:20:57] ax.service.ax_client: Generated new trial 16 with parameters {'lr': 0.000837, 'momentum': 0.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:04] ax.service.ax_client: Completed trial 16 with data: {'accuracy': (0.870333, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:05] ax.service.ax_client: Generated new trial 17 with parameters {'lr': 0.000573, 'momentum': 0.790425} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:11] ax.service.ax_client: Completed trial 17 with data: {'accuracy': (0.943833, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:12] ax.service.ax_client: Generated new trial 18 with parameters {'lr': 0.000564, 'momentum': 0.479924} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:19] ax.service.ax_client: Completed trial 18 with data: {'accuracy': (0.912333, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:20] ax.modelbridge.base: Untransformed parameter 0.40000000000000013 greater than upper bound 0.4, clamping\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:20] ax.service.ax_client: Generated new trial 19 with parameters {'lr': 0.4, 'momentum': 0.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:26] ax.service.ax_client: Completed trial 19 with data: {'accuracy': (0.101, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:27] ax.service.ax_client: Generated new trial 20 with parameters {'lr': 0.000315, 'momentum': 0.777594} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:34] ax.service.ax_client: Completed trial 20 with data: {'accuracy': (0.203667, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:34] ax.service.ax_client: Generated new trial 21 with parameters {'lr': 3.5e-05, 'momentum': 0.76736} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:41] ax.service.ax_client: Completed trial 21 with data: {'accuracy': (0.881833, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:42] ax.service.ax_client: Generated new trial 22 with parameters {'lr': 0.0001, 'momentum': 0.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:49] ax.service.ax_client: Completed trial 22 with data: {'accuracy': (0.873167, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:49] ax.service.ax_client: Generated new trial 23 with parameters {'lr': 7.6e-05, 'momentum': 0.471701} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:56] ax.service.ax_client: Completed trial 23 with data: {'accuracy': (0.9015, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:21:57] ax.service.ax_client: Generated new trial 24 with parameters {'lr': 0.000353, 'momentum': 0.183083} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:03] ax.service.ax_client: Completed trial 24 with data: {'accuracy': (0.913333, None)}.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:04] ax.service.ax_client: Generated new trial 25 with parameters {'lr': 0.001072, 'momentum': 1.0} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:11] ax.service.ax_client: Completed trial 25 with data: {'accuracy': (0.102667, None)}.\n"
]
}
],
"source": [
"for i in range(25):\n",
" parameters, trial_index = ax_client.get_next_trial()\n",
" # Local evaluation here can be replaced with deployment to external system.\n",
" ax_client.complete_trial(trial_index=trial_index, raw_data=train_evaluate(parameters))"
]
},
{
"cell_type": "markdown",
"id": "5b471342",
"metadata": {
"customInput": null,
"originalKey": "ccd16059-db9f-475b-b527-75afb320e0f4",
"papermill": {
"duration": 0.042324,
"end_time": "2024-05-13T05:22:11.193730",
"exception": false,
"start_time": "2024-05-13T05:22:11.151406",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"### How many trials can run in parallel?\n",
"By default, Ax restricts number of trials that can run in parallel for some optimization stages, in order to improve the optimization performance and reduce the number of trials that the optimization will require. To check the maximum parallelism for each optimization stage:"
]
},
{
"cell_type": "code",
"execution_count": 10,
"id": "a978f914",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:11.274543Z",
"iopub.status.busy": "2024-05-13T05:22:11.273945Z",
"iopub.status.idle": "2024-05-13T05:22:11.280828Z",
"shell.execute_reply": "2024-05-13T05:22:11.280254Z"
},
"executionStartTime": 1690415945269,
"executionStopTime": 1690415945336,
"originalKey": "7182d2f9-912c-464c-b5ad-f65ce6f00017",
"papermill": {
"duration": 0.048398,
"end_time": "2024-05-13T05:22:11.282131",
"exception": false,
"start_time": "2024-05-13T05:22:11.233733",
"status": "completed"
},
"requestMsgId": "4cb4ff79-e45b-4c7d-86a1-7f8007eb2c81",
"showInput": true,
"tags": []
},
"outputs": [
{
"data": {
"text/plain": [
"[(5, 5), (-1, 3)]"
]
},
"execution_count": 10,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"ax_client.get_max_parallelism()"
]
},
{
"cell_type": "markdown",
"id": "841b43b5",
"metadata": {
"customInput": null,
"originalKey": "e2f429e6-2ec8-4af2-906b-52a36a53d329",
"papermill": {
"duration": 0.03919,
"end_time": "2024-05-13T05:22:11.360776",
"exception": false,
"start_time": "2024-05-13T05:22:11.321586",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"The output of this function is a list of tuples of form (number of trials, max parallelism), so the example above means \"the max parallelism is 5 for the first 5 trials and 3 for all subsequent trials.\" This is because the first 5 trials are produced quasi-randomly and can all be evaluated at once, and subsequent trials are produced via Bayesian optimization, which converges on optimal point in fewer trials when parallelism is limited. MaxParallelismReachedException indicates that the parallelism limit has been reached –– refer to the 'Service API Exceptions Meaning and Handling' section at the end of the tutorial for handling.\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "ce0a0382",
"metadata": {
"customInput": null,
"originalKey": "86c7aef9-993a-411e-add5-05839b00d3cf",
"papermill": {
"duration": 0.038988,
"end_time": "2024-05-13T05:22:11.438979",
"exception": false,
"start_time": "2024-05-13T05:22:11.399991",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"### How to view all existing trials during optimization?"
]
},
{
"cell_type": "code",
"execution_count": 11,
"id": "9c0fd562",
"metadata": {
"customInput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:11.518768Z",
"iopub.status.busy": "2024-05-13T05:22:11.518476Z",
"iopub.status.idle": "2024-05-13T05:22:11.548574Z",
"shell.execute_reply": "2024-05-13T05:22:11.548006Z"
},
"executionStartTime": 1690415945532,
"executionStopTime": 1690415946199,
"originalKey": "3fbad5dc-863a-494e-b04f-d7dc1e47936c",
"papermill": {
"duration": 0.071769,
"end_time": "2024-05-13T05:22:11.549773",
"exception": false,
"start_time": "2024-05-13T05:22:11.478004",
"status": "completed"
},
"requestMsgId": "905ea8b6-add0-473e-8516-5be6ad7d7658",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[WARNING 05-13 05:22:11] ax.service.utils.report_utils: Column reason missing for all trials. Not appending column.\n"
]
},
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" | \n",
" trial_index | \n",
" arm_name | \n",
" trial_status | \n",
" generation_method | \n",
" accuracy | \n",
" lr | \n",
" momentum | \n",
"
\n",
" \n",
" \n",
" \n",
" | 0 | \n",
" 0 | \n",
" 0_0 | \n",
" COMPLETED | \n",
" Manual | \n",
" 0.841833 | \n",
" 0.000026 | \n",
" 0.580000 | \n",
"
\n",
" \n",
" | 1 | \n",
" 1 | \n",
" 1_0 | \n",
" COMPLETED | \n",
" Sobol | \n",
" 0.100333 | \n",
" 0.009955 | \n",
" 0.633423 | \n",
"
\n",
" \n",
" | 2 | \n",
" 2 | \n",
" 2_0 | \n",
" COMPLETED | \n",
" Sobol | \n",
" 0.318667 | \n",
" 0.000005 | \n",
" 0.022851 | \n",
"
\n",
" \n",
" | 3 | \n",
" 3 | \n",
" 3_0 | \n",
" COMPLETED | \n",
" Sobol | \n",
" 0.458500 | \n",
" 0.000007 | \n",
" 0.176948 | \n",
"
\n",
" \n",
" | 4 | \n",
" 4 | \n",
" 4_0 | \n",
" COMPLETED | \n",
" Sobol | \n",
" 0.926000 | \n",
" 0.000082 | \n",
" 0.908830 | \n",
"
\n",
" \n",
" | 5 | \n",
" 5 | \n",
" 5_0 | \n",
" COMPLETED | \n",
" Sobol | \n",
" 0.929000 | \n",
" 0.000302 | \n",
" 0.341904 | \n",
"
\n",
" \n",
" | 6 | \n",
" 6 | \n",
" 6_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.920000 | \n",
" 0.000137 | \n",
" 0.590917 | \n",
"
\n",
" \n",
" | 7 | \n",
" 7 | \n",
" 7_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.860167 | \n",
" 0.000010 | \n",
" 1.000000 | \n",
"
\n",
" \n",
" | 8 | \n",
" 8 | \n",
" 8_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.888833 | \n",
" 0.000246 | \n",
" 0.000000 | \n",
"
\n",
" \n",
" | 9 | \n",
" 9 | \n",
" 9_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.901667 | \n",
" 0.000149 | \n",
" 0.286357 | \n",
"
\n",
" \n",
" | 10 | \n",
" 10 | \n",
" 10_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.560333 | \n",
" 0.000001 | \n",
" 1.000000 | \n",
"
\n",
" \n",
" | 11 | \n",
" 11 | \n",
" 11_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.759167 | \n",
" 0.000037 | \n",
" 1.000000 | \n",
"
\n",
" \n",
" | 12 | \n",
" 12 | \n",
" 12_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.945333 | \n",
" 0.000261 | \n",
" 0.913550 | \n",
"
\n",
" \n",
" | 13 | \n",
" 13 | \n",
" 13_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.942833 | \n",
" 0.000170 | \n",
" 0.799113 | \n",
"
\n",
" \n",
" | 14 | \n",
" 14 | \n",
" 14_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.842833 | \n",
" 0.000159 | \n",
" 1.000000 | \n",
"
\n",
" \n",
" | 15 | \n",
" 15 | \n",
" 15_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.945833 | \n",
" 0.000311 | \n",
" 0.665002 | \n",
"
\n",
" \n",
" | 16 | \n",
" 16 | \n",
" 16_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.870333 | \n",
" 0.000837 | \n",
" 0.000000 | \n",
"
\n",
" \n",
" | 17 | \n",
" 17 | \n",
" 17_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.943833 | \n",
" 0.000573 | \n",
" 0.790425 | \n",
"
\n",
" \n",
" | 18 | \n",
" 18 | \n",
" 18_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.912333 | \n",
" 0.000564 | \n",
" 0.479924 | \n",
"
\n",
" \n",
" | 19 | \n",
" 19 | \n",
" 19_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.101000 | \n",
" 0.400000 | \n",
" 0.000000 | \n",
"
\n",
" \n",
" | 20 | \n",
" 20 | \n",
" 20_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.203667 | \n",
" 0.000315 | \n",
" 0.777594 | \n",
"
\n",
" \n",
" | 21 | \n",
" 21 | \n",
" 21_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.881833 | \n",
" 0.000035 | \n",
" 0.767360 | \n",
"
\n",
" \n",
" | 22 | \n",
" 22 | \n",
" 22_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.873167 | \n",
" 0.000100 | \n",
" 0.000000 | \n",
"
\n",
" \n",
" | 23 | \n",
" 23 | \n",
" 23_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.901500 | \n",
" 0.000076 | \n",
" 0.471701 | \n",
"
\n",
" \n",
" | 24 | \n",
" 24 | \n",
" 24_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.913333 | \n",
" 0.000353 | \n",
" 0.183083 | \n",
"
\n",
" \n",
" | 25 | \n",
" 25 | \n",
" 25_0 | \n",
" COMPLETED | \n",
" BoTorch | \n",
" 0.102667 | \n",
" 0.001072 | \n",
" 1.000000 | \n",
"
\n",
" \n",
"
\n",
"
accuracy: 0.841833 (SEM: None)
lr: 2.6e-05
momentum: 0.58",
"Arm 1_0
accuracy: 0.100333 (SEM: None)
lr: 0.00995509
momentum: 0.633423",
"Arm 2_0
accuracy: 0.318667 (SEM: None)
lr: 5.18336e-06
momentum: 0.0228515",
"Arm 3_0
accuracy: 0.4585 (SEM: None)
lr: 6.63497e-06
momentum: 0.176948",
"Arm 4_0
accuracy: 0.926 (SEM: None)
lr: 8.15482e-05
momentum: 0.90883",
"Arm 5_0
accuracy: 0.929 (SEM: None)
lr: 0.000302077
momentum: 0.341904",
"Arm 6_0
accuracy: 0.92 (SEM: None)
lr: 0.000137311
momentum: 0.590917",
"Arm 7_0
accuracy: 0.860167 (SEM: None)
lr: 1.03262e-05
momentum: 1",
"Arm 8_0
accuracy: 0.888833 (SEM: None)
lr: 0.000246295
momentum: 0",
"Arm 9_0
accuracy: 0.901667 (SEM: None)
lr: 0.000149439
momentum: 0.286357",
"Arm 10_0
accuracy: 0.560333 (SEM: None)
lr: 1e-06
momentum: 1",
"Arm 11_0
accuracy: 0.759167 (SEM: None)
lr: 3.73218e-05
momentum: 1",
"Arm 12_0
accuracy: 0.945333 (SEM: None)
lr: 0.000261046
momentum: 0.91355",
"Arm 13_0
accuracy: 0.942833 (SEM: None)
lr: 0.000170431
momentum: 0.799113",
"Arm 14_0
accuracy: 0.842833 (SEM: None)
lr: 0.000158728
momentum: 1",
"Arm 15_0
accuracy: 0.945833 (SEM: None)
lr: 0.000310546
momentum: 0.665002",
"Arm 16_0
accuracy: 0.870333 (SEM: None)
lr: 0.000836774
momentum: 0",
"Arm 17_0
accuracy: 0.943833 (SEM: None)
lr: 0.000572854
momentum: 0.790425",
"Arm 18_0
accuracy: 0.912333 (SEM: None)
lr: 0.000563705
momentum: 0.479924",
"Arm 19_0
accuracy: 0.101 (SEM: None)
lr: 0.4
momentum: 0",
"Arm 20_0
accuracy: 0.203667 (SEM: None)
lr: 0.000314755
momentum: 0.777594",
"Arm 21_0
accuracy: 0.881833 (SEM: None)
lr: 3.47393e-05
momentum: 0.76736",
"Arm 22_0
accuracy: 0.873167 (SEM: None)
lr: 0.000100187
momentum: 0",
"Arm 23_0
accuracy: 0.9015 (SEM: None)
lr: 7.63425e-05
momentum: 0.471701",
"Arm 24_0
accuracy: 0.913333 (SEM: None)
lr: 0.00035258
momentum: 0.183083"
],
"type": "scatter",
"x": [
2.6e-05,
0.00995509203921593,
5.183362665905935e-06,
6.6349677287433636e-06,
8.154817047148868e-05,
0.000302076728574865,
0.00013731096665846605,
1.0326238819187764e-05,
0.00024629479479540775,
0.0001494385653033887,
1e-06,
3.732184410050388e-05,
0.0002610460173347585,
0.0001704311281854437,
0.00015872762260578225,
0.00031054584535304577,
0.0008367735334414118,
0.0005728536520635165,
0.0005637049589970559,
0.4,
0.0003147550527241065,
3.473928755567143e-05,
0.00010018704633631847,
7.634249037888073e-05,
0.0003525795556828365
],
"xaxis": "x",
"y": [
0.58,
0.6334228515625,
0.022851496934890747,
0.1769482558593154,
0.9088304992765188,
0.34190391190350056,
0.5909173150416861,
1.0,
0.0,
0.2863569208604894,
1.0,
1.0,
0.9135498623676301,
0.7991127998404972,
1.0,
0.665001895649106,
0.0,
0.7904247793656229,
0.479924033515976,
0.0,
0.7775944991992201,
0.7673599449304487,
0.0,
0.4717011028463039,
0.18308293645958593
],
"yaxis": "y"
},
{
"hoverinfo": "text",
"legendgroup": "In-sample",
"marker": {
"color": "black",
"opacity": 0.5,
"symbol": 1
},
"mode": "markers",
"name": "In-sample",
"showlegend": false,
"text": [
"Arm 0_0
accuracy: 0.841833 (SEM: None)
lr: 2.6e-05
momentum: 0.58",
"Arm 1_0
accuracy: 0.100333 (SEM: None)
lr: 0.00995509
momentum: 0.633423",
"Arm 2_0
accuracy: 0.318667 (SEM: None)
lr: 5.18336e-06
momentum: 0.0228515",
"Arm 3_0
accuracy: 0.4585 (SEM: None)
lr: 6.63497e-06
momentum: 0.176948",
"Arm 4_0
accuracy: 0.926 (SEM: None)
lr: 8.15482e-05
momentum: 0.90883",
"Arm 5_0
accuracy: 0.929 (SEM: None)
lr: 0.000302077
momentum: 0.341904",
"Arm 6_0
accuracy: 0.92 (SEM: None)
lr: 0.000137311
momentum: 0.590917",
"Arm 7_0
accuracy: 0.860167 (SEM: None)
lr: 1.03262e-05
momentum: 1",
"Arm 8_0
accuracy: 0.888833 (SEM: None)
lr: 0.000246295
momentum: 0",
"Arm 9_0
accuracy: 0.901667 (SEM: None)
lr: 0.000149439
momentum: 0.286357",
"Arm 10_0
accuracy: 0.560333 (SEM: None)
lr: 1e-06
momentum: 1",
"Arm 11_0
accuracy: 0.759167 (SEM: None)
lr: 3.73218e-05
momentum: 1",
"Arm 12_0
accuracy: 0.945333 (SEM: None)
lr: 0.000261046
momentum: 0.91355",
"Arm 13_0
accuracy: 0.942833 (SEM: None)
lr: 0.000170431
momentum: 0.799113",
"Arm 14_0
accuracy: 0.842833 (SEM: None)
lr: 0.000158728
momentum: 1",
"Arm 15_0
accuracy: 0.945833 (SEM: None)
lr: 0.000310546
momentum: 0.665002",
"Arm 16_0
accuracy: 0.870333 (SEM: None)
lr: 0.000836774
momentum: 0",
"Arm 17_0
accuracy: 0.943833 (SEM: None)
lr: 0.000572854
momentum: 0.790425",
"Arm 18_0
accuracy: 0.912333 (SEM: None)
lr: 0.000563705
momentum: 0.479924",
"Arm 19_0
accuracy: 0.101 (SEM: None)
lr: 0.4
momentum: 0",
"Arm 20_0
accuracy: 0.203667 (SEM: None)
lr: 0.000314755
momentum: 0.777594",
"Arm 21_0
accuracy: 0.881833 (SEM: None)
lr: 3.47393e-05
momentum: 0.76736",
"Arm 22_0
accuracy: 0.873167 (SEM: None)
lr: 0.000100187
momentum: 0",
"Arm 23_0
accuracy: 0.9015 (SEM: None)
lr: 7.63425e-05
momentum: 0.471701",
"Arm 24_0
accuracy: 0.913333 (SEM: None)
lr: 0.00035258
momentum: 0.183083"
],
"type": "scatter",
"x": [
2.6e-05,
0.00995509203921593,
5.183362665905935e-06,
6.6349677287433636e-06,
8.154817047148868e-05,
0.000302076728574865,
0.00013731096665846605,
1.0326238819187764e-05,
0.00024629479479540775,
0.0001494385653033887,
1e-06,
3.732184410050388e-05,
0.0002610460173347585,
0.0001704311281854437,
0.00015872762260578225,
0.00031054584535304577,
0.0008367735334414118,
0.0005728536520635165,
0.0005637049589970559,
0.4,
0.0003147550527241065,
3.473928755567143e-05,
0.00010018704633631847,
7.634249037888073e-05,
0.0003525795556828365
],
"xaxis": "x2",
"y": [
0.58,
0.6334228515625,
0.022851496934890747,
0.1769482558593154,
0.9088304992765188,
0.34190391190350056,
0.5909173150416861,
1.0,
0.0,
0.2863569208604894,
1.0,
1.0,
0.9135498623676301,
0.7991127998404972,
1.0,
0.665001895649106,
0.0,
0.7904247793656229,
0.479924033515976,
0.0,
0.7775944991992201,
0.7673599449304487,
0.0,
0.4717011028463039,
0.18308293645958593
],
"yaxis": "y2"
}
],
"layout": {
"annotations": [
{
"font": {
"size": 14
},
"showarrow": false,
"text": "Mean",
"x": 0.25,
"xanchor": "center",
"xref": "paper",
"y": 1,
"yanchor": "bottom",
"yref": "paper"
},
{
"font": {
"size": 14
},
"showarrow": false,
"text": "Standard Error",
"x": 0.8,
"xanchor": "center",
"xref": "paper",
"y": 1,
"yanchor": "bottom",
"yref": "paper"
}
],
"autosize": false,
"height": 450,
"hovermode": "closest",
"legend": {
"orientation": "h",
"x": 0,
"y": -0.25
},
"margin": {
"b": 100,
"l": 35,
"pad": 0,
"r": 35,
"t": 35
},
"template": {
"data": {
"bar": [
{
"error_x": {
"color": "#2a3f5f"
},
"error_y": {
"color": "#2a3f5f"
},
"marker": {
"line": {
"color": "#E5ECF6",
"width": 0.5
},
"pattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
}
},
"type": "bar"
}
],
"barpolar": [
{
"marker": {
"line": {
"color": "#E5ECF6",
"width": 0.5
},
"pattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
}
},
"type": "barpolar"
}
],
"carpet": [
{
"aaxis": {
"endlinecolor": "#2a3f5f",
"gridcolor": "white",
"linecolor": "white",
"minorgridcolor": "white",
"startlinecolor": "#2a3f5f"
},
"baxis": {
"endlinecolor": "#2a3f5f",
"gridcolor": "white",
"linecolor": "white",
"minorgridcolor": "white",
"startlinecolor": "#2a3f5f"
},
"type": "carpet"
}
],
"choropleth": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"type": "choropleth"
}
],
"contour": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "contour"
}
],
"contourcarpet": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"type": "contourcarpet"
}
],
"heatmap": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "heatmap"
}
],
"heatmapgl": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "heatmapgl"
}
],
"histogram": [
{
"marker": {
"pattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
}
},
"type": "histogram"
}
],
"histogram2d": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "histogram2d"
}
],
"histogram2dcontour": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "histogram2dcontour"
}
],
"mesh3d": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"type": "mesh3d"
}
],
"parcoords": [
{
"line": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "parcoords"
}
],
"pie": [
{
"automargin": true,
"type": "pie"
}
],
"scatter": [
{
"fillpattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
},
"type": "scatter"
}
],
"scatter3d": [
{
"line": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatter3d"
}
],
"scattercarpet": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattercarpet"
}
],
"scattergeo": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattergeo"
}
],
"scattergl": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattergl"
}
],
"scattermapbox": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattermapbox"
}
],
"scatterpolar": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatterpolar"
}
],
"scatterpolargl": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatterpolargl"
}
],
"scatterternary": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatterternary"
}
],
"surface": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "surface"
}
],
"table": [
{
"cells": {
"fill": {
"color": "#EBF0F8"
},
"line": {
"color": "white"
}
},
"header": {
"fill": {
"color": "#C8D4E3"
},
"line": {
"color": "white"
}
},
"type": "table"
}
]
},
"layout": {
"annotationdefaults": {
"arrowcolor": "#2a3f5f",
"arrowhead": 0,
"arrowwidth": 1
},
"autotypenumbers": "strict",
"coloraxis": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"colorscale": {
"diverging": [
[
0,
"#8e0152"
],
[
0.1,
"#c51b7d"
],
[
0.2,
"#de77ae"
],
[
0.3,
"#f1b6da"
],
[
0.4,
"#fde0ef"
],
[
0.5,
"#f7f7f7"
],
[
0.6,
"#e6f5d0"
],
[
0.7,
"#b8e186"
],
[
0.8,
"#7fbc41"
],
[
0.9,
"#4d9221"
],
[
1,
"#276419"
]
],
"sequential": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"sequentialminus": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
]
},
"colorway": [
"#636efa",
"#EF553B",
"#00cc96",
"#ab63fa",
"#FFA15A",
"#19d3f3",
"#FF6692",
"#B6E880",
"#FF97FF",
"#FECB52"
],
"font": {
"color": "#2a3f5f"
},
"geo": {
"bgcolor": "white",
"lakecolor": "white",
"landcolor": "#E5ECF6",
"showlakes": true,
"showland": true,
"subunitcolor": "white"
},
"hoverlabel": {
"align": "left"
},
"hovermode": "closest",
"mapbox": {
"style": "light"
},
"paper_bgcolor": "white",
"plot_bgcolor": "#E5ECF6",
"polar": {
"angularaxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
},
"bgcolor": "#E5ECF6",
"radialaxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
}
},
"scene": {
"xaxis": {
"backgroundcolor": "#E5ECF6",
"gridcolor": "white",
"gridwidth": 2,
"linecolor": "white",
"showbackground": true,
"ticks": "",
"zerolinecolor": "white"
},
"yaxis": {
"backgroundcolor": "#E5ECF6",
"gridcolor": "white",
"gridwidth": 2,
"linecolor": "white",
"showbackground": true,
"ticks": "",
"zerolinecolor": "white"
},
"zaxis": {
"backgroundcolor": "#E5ECF6",
"gridcolor": "white",
"gridwidth": 2,
"linecolor": "white",
"showbackground": true,
"ticks": "",
"zerolinecolor": "white"
}
},
"shapedefaults": {
"line": {
"color": "#2a3f5f"
}
},
"ternary": {
"aaxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
},
"baxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
},
"bgcolor": "#E5ECF6",
"caxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
}
},
"title": {
"x": 0.05
},
"xaxis": {
"automargin": true,
"gridcolor": "white",
"linecolor": "white",
"ticks": "",
"title": {
"standoff": 15
},
"zerolinecolor": "white",
"zerolinewidth": 2
},
"yaxis": {
"automargin": true,
"gridcolor": "white",
"linecolor": "white",
"ticks": "",
"title": {
"standoff": 15
},
"zerolinecolor": "white",
"zerolinewidth": 2
}
}
},
"title": {
"text": "accuracy"
},
"width": 950,
"xaxis": {
"anchor": "y",
"autorange": false,
"domain": [
0.05,
0.45
],
"exponentformat": "e",
"range": [
-6.0,
-0.3979400086720376
],
"tickfont": {
"size": 11
},
"tickmode": "auto",
"title": {
"text": "lr"
},
"type": "log"
},
"xaxis2": {
"anchor": "y2",
"autorange": false,
"domain": [
0.6,
1
],
"exponentformat": "e",
"range": [
-6.0,
-0.3979400086720376
],
"tickfont": {
"size": 11
},
"tickmode": "auto",
"title": {
"text": "lr"
},
"type": "log"
},
"yaxis": {
"anchor": "x",
"autorange": false,
"domain": [
0,
1
],
"exponentformat": "e",
"range": [
0.0,
1.0
],
"tickfont": {
"size": 11
},
"tickmode": "auto",
"title": {
"text": "momentum"
},
"type": "linear"
},
"yaxis2": {
"anchor": "x2",
"autorange": false,
"domain": [
0,
1
],
"exponentformat": "e",
"range": [
0.0,
1.0
],
"tickfont": {
"size": 11
},
"tickmode": "auto",
"type": "linear"
}
}
},
"text/html": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"render(ax_client.get_contour_plot(param_x=\"lr\", param_y=\"momentum\", metric_name=\"accuracy\"))"
]
},
{
"cell_type": "markdown",
"id": "b2dd9ec1",
"metadata": {
"customInput": null,
"originalKey": "5c91d83a-9a90-4ea0-8df9-9d242d998cb3",
"papermill": {
"duration": 0.054524,
"end_time": "2024-05-13T05:22:13.024062",
"exception": false,
"start_time": "2024-05-13T05:22:12.969538",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"Here we plot the optimization trace, showing the progression of finding the point with the optimal objective:\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 15,
"id": "6eaf3ac5",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:13.133725Z",
"iopub.status.busy": "2024-05-13T05:22:13.133435Z",
"iopub.status.idle": "2024-05-13T05:22:13.183140Z",
"shell.execute_reply": "2024-05-13T05:22:13.182452Z"
},
"executionStartTime": 1690415953760,
"executionStopTime": 1690415954260,
"originalKey": "3a767bdf-7ef3-48e7-b853-6fae5e9e02ff",
"papermill": {
"duration": 0.106035,
"end_time": "2024-05-13T05:22:13.184432",
"exception": false,
"start_time": "2024-05-13T05:22:13.078397",
"status": "completed"
},
"requestMsgId": "043de459-6a28-4796-b237-808385c9e54c",
"showInput": true,
"tags": []
},
"outputs": [
{
"data": {
"application/vnd.plotly.v1+json": {
"config": {
"linkText": "Export to plot.ly",
"plotlyServerURL": "https://plot.ly",
"showLink": false
},
"data": [
{
"hoverinfo": "none",
"legendgroup": "",
"line": {
"width": 0
},
"mode": "lines",
"showlegend": false,
"type": "scatter",
"x": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26
],
"y": [
0.8418333333333333,
0.8418333333333333,
0.8418333333333333,
0.8418333333333333,
0.926,
0.929,
0.929,
0.929,
0.929,
0.929,
0.929,
0.929,
0.9453333333333334,
0.9453333333333334,
0.9453333333333334,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333
]
},
{
"fill": "tonexty",
"fillcolor": "rgba(128,177,211,0.3)",
"legendgroup": "objective value",
"line": {
"color": "rgba(128,177,211,1)"
},
"mode": "lines",
"name": "objective value",
"text": [
"
Parameterization:
lr: 2.6e-05
momentum: 0.58",
"
Parameterization:
lr: 0.00995509203921593
momentum: 0.6334228515625",
"
Parameterization:
lr: 5.183362665905935e-06
momentum: 0.022851496934890747",
"
Parameterization:
lr: 6.6349677287433636e-06
momentum: 0.1769482558593154",
"
Parameterization:
lr: 8.154817047148868e-05
momentum: 0.9088304992765188",
"
Parameterization:
lr: 0.000302076728574865
momentum: 0.34190391190350056",
"
Parameterization:
lr: 0.00013731096665846605
momentum: 0.5909173150416861",
"
Parameterization:
lr: 1.0326238819187764e-05
momentum: 1.0",
"
Parameterization:
lr: 0.00024629479479540775
momentum: 0.0",
"
Parameterization:
lr: 0.0001494385653033887
momentum: 0.2863569208604894",
"
Parameterization:
lr: 1e-06
momentum: 1.0",
"
Parameterization:
lr: 3.732184410050388e-05
momentum: 1.0",
"
Parameterization:
lr: 0.0002610460173347585
momentum: 0.9135498623676301",
"
Parameterization:
lr: 0.0001704311281854437
momentum: 0.7991127998404972",
"
Parameterization:
lr: 0.00015872762260578225
momentum: 1.0",
"
Parameterization:
lr: 0.00031054584535304577
momentum: 0.665001895649106",
"
Parameterization:
lr: 0.0008367735334414118
momentum: 0.0",
"
Parameterization:
lr: 0.0005728536520635165
momentum: 0.7904247793656229",
"
Parameterization:
lr: 0.0005637049589970559
momentum: 0.479924033515976",
"
Parameterization:
lr: 0.4
momentum: 0.0",
"
Parameterization:
lr: 0.0003147550527241065
momentum: 0.7775944991992201",
"
Parameterization:
lr: 3.473928755567143e-05
momentum: 0.7673599449304487",
"
Parameterization:
lr: 0.00010018704633631847
momentum: 0.0",
"
Parameterization:
lr: 7.634249037888073e-05
momentum: 0.4717011028463039",
"
Parameterization:
lr: 0.0003525795556828365
momentum: 0.18308293645958593",
"
Parameterization:
lr: 0.0010716582482886152
momentum: 1.0"
],
"type": "scatter",
"x": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26
],
"y": [
0.8418333333333333,
0.8418333333333333,
0.8418333333333333,
0.8418333333333333,
0.926,
0.929,
0.929,
0.929,
0.929,
0.929,
0.929,
0.929,
0.9453333333333334,
0.9453333333333334,
0.9453333333333334,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333
]
},
{
"fill": "tonexty",
"fillcolor": "rgba(128,177,211,0.3)",
"hoverinfo": "none",
"legendgroup": "",
"line": {
"width": 0
},
"mode": "lines",
"showlegend": false,
"type": "scatter",
"x": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26
],
"y": [
0.8418333333333333,
0.8418333333333333,
0.8418333333333333,
0.8418333333333333,
0.926,
0.929,
0.929,
0.929,
0.929,
0.929,
0.929,
0.929,
0.9453333333333334,
0.9453333333333334,
0.9453333333333334,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333,
0.9458333333333333
]
}
],
"layout": {
"showlegend": true,
"template": {
"data": {
"bar": [
{
"error_x": {
"color": "#2a3f5f"
},
"error_y": {
"color": "#2a3f5f"
},
"marker": {
"line": {
"color": "#E5ECF6",
"width": 0.5
},
"pattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
}
},
"type": "bar"
}
],
"barpolar": [
{
"marker": {
"line": {
"color": "#E5ECF6",
"width": 0.5
},
"pattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
}
},
"type": "barpolar"
}
],
"carpet": [
{
"aaxis": {
"endlinecolor": "#2a3f5f",
"gridcolor": "white",
"linecolor": "white",
"minorgridcolor": "white",
"startlinecolor": "#2a3f5f"
},
"baxis": {
"endlinecolor": "#2a3f5f",
"gridcolor": "white",
"linecolor": "white",
"minorgridcolor": "white",
"startlinecolor": "#2a3f5f"
},
"type": "carpet"
}
],
"choropleth": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"type": "choropleth"
}
],
"contour": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "contour"
}
],
"contourcarpet": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"type": "contourcarpet"
}
],
"heatmap": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "heatmap"
}
],
"heatmapgl": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "heatmapgl"
}
],
"histogram": [
{
"marker": {
"pattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
}
},
"type": "histogram"
}
],
"histogram2d": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "histogram2d"
}
],
"histogram2dcontour": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "histogram2dcontour"
}
],
"mesh3d": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"type": "mesh3d"
}
],
"parcoords": [
{
"line": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "parcoords"
}
],
"pie": [
{
"automargin": true,
"type": "pie"
}
],
"scatter": [
{
"fillpattern": {
"fillmode": "overlay",
"size": 10,
"solidity": 0.2
},
"type": "scatter"
}
],
"scatter3d": [
{
"line": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatter3d"
}
],
"scattercarpet": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattercarpet"
}
],
"scattergeo": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattergeo"
}
],
"scattergl": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattergl"
}
],
"scattermapbox": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scattermapbox"
}
],
"scatterpolar": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatterpolar"
}
],
"scatterpolargl": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatterpolargl"
}
],
"scatterternary": [
{
"marker": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"type": "scatterternary"
}
],
"surface": [
{
"colorbar": {
"outlinewidth": 0,
"ticks": ""
},
"colorscale": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"type": "surface"
}
],
"table": [
{
"cells": {
"fill": {
"color": "#EBF0F8"
},
"line": {
"color": "white"
}
},
"header": {
"fill": {
"color": "#C8D4E3"
},
"line": {
"color": "white"
}
},
"type": "table"
}
]
},
"layout": {
"annotationdefaults": {
"arrowcolor": "#2a3f5f",
"arrowhead": 0,
"arrowwidth": 1
},
"autotypenumbers": "strict",
"coloraxis": {
"colorbar": {
"outlinewidth": 0,
"ticks": ""
}
},
"colorscale": {
"diverging": [
[
0,
"#8e0152"
],
[
0.1,
"#c51b7d"
],
[
0.2,
"#de77ae"
],
[
0.3,
"#f1b6da"
],
[
0.4,
"#fde0ef"
],
[
0.5,
"#f7f7f7"
],
[
0.6,
"#e6f5d0"
],
[
0.7,
"#b8e186"
],
[
0.8,
"#7fbc41"
],
[
0.9,
"#4d9221"
],
[
1,
"#276419"
]
],
"sequential": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
],
"sequentialminus": [
[
0.0,
"#0d0887"
],
[
0.1111111111111111,
"#46039f"
],
[
0.2222222222222222,
"#7201a8"
],
[
0.3333333333333333,
"#9c179e"
],
[
0.4444444444444444,
"#bd3786"
],
[
0.5555555555555556,
"#d8576b"
],
[
0.6666666666666666,
"#ed7953"
],
[
0.7777777777777778,
"#fb9f3a"
],
[
0.8888888888888888,
"#fdca26"
],
[
1.0,
"#f0f921"
]
]
},
"colorway": [
"#636efa",
"#EF553B",
"#00cc96",
"#ab63fa",
"#FFA15A",
"#19d3f3",
"#FF6692",
"#B6E880",
"#FF97FF",
"#FECB52"
],
"font": {
"color": "#2a3f5f"
},
"geo": {
"bgcolor": "white",
"lakecolor": "white",
"landcolor": "#E5ECF6",
"showlakes": true,
"showland": true,
"subunitcolor": "white"
},
"hoverlabel": {
"align": "left"
},
"hovermode": "closest",
"mapbox": {
"style": "light"
},
"paper_bgcolor": "white",
"plot_bgcolor": "#E5ECF6",
"polar": {
"angularaxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
},
"bgcolor": "#E5ECF6",
"radialaxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
}
},
"scene": {
"xaxis": {
"backgroundcolor": "#E5ECF6",
"gridcolor": "white",
"gridwidth": 2,
"linecolor": "white",
"showbackground": true,
"ticks": "",
"zerolinecolor": "white"
},
"yaxis": {
"backgroundcolor": "#E5ECF6",
"gridcolor": "white",
"gridwidth": 2,
"linecolor": "white",
"showbackground": true,
"ticks": "",
"zerolinecolor": "white"
},
"zaxis": {
"backgroundcolor": "#E5ECF6",
"gridcolor": "white",
"gridwidth": 2,
"linecolor": "white",
"showbackground": true,
"ticks": "",
"zerolinecolor": "white"
}
},
"shapedefaults": {
"line": {
"color": "#2a3f5f"
}
},
"ternary": {
"aaxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
},
"baxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
},
"bgcolor": "#E5ECF6",
"caxis": {
"gridcolor": "white",
"linecolor": "white",
"ticks": ""
}
},
"title": {
"x": 0.05
},
"xaxis": {
"automargin": true,
"gridcolor": "white",
"linecolor": "white",
"ticks": "",
"title": {
"standoff": 15
},
"zerolinecolor": "white",
"zerolinewidth": 2
},
"yaxis": {
"automargin": true,
"gridcolor": "white",
"linecolor": "white",
"ticks": "",
"title": {
"standoff": 15
},
"zerolinecolor": "white",
"zerolinewidth": 2
}
}
},
"title": {
"text": "Best objective found vs. # of iterations"
},
"xaxis": {
"title": {
"text": "Iteration"
}
},
"yaxis": {
"title": {
"text": "Accuracy"
}
}
}
},
"text/html": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"render(\n",
" ax_client.get_optimization_trace()\n",
") "
]
},
{
"cell_type": "markdown",
"id": "e2a64675",
"metadata": {
"customInput": null,
"executionStartTime": 1689617061294,
"executionStopTime": 1689617061325,
"originalKey": "09aaec9d-c178-42e2-b549-663cd17f8c3d",
"papermill": {
"duration": 0.057662,
"end_time": "2024-05-13T05:22:13.300257",
"exception": false,
"start_time": "2024-05-13T05:22:13.242595",
"status": "completed"
},
"requestMsgId": "09aaec9d-c178-42e2-b549-663cd17f8c3d",
"showInput": false,
"tags": []
},
"source": [
"## 8. Train CNN with best hyperparameters and evaluate on test set\n",
"Note that the resulting accuracy on the test set generally won't be the same as the maximum accuracy achieved on the evaluation set throughout optimization. "
]
},
{
"cell_type": "code",
"execution_count": 16,
"id": "e3c8ec7c",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:13.418019Z",
"iopub.status.busy": "2024-05-13T05:22:13.417726Z",
"iopub.status.idle": "2024-05-13T05:22:13.441055Z",
"shell.execute_reply": "2024-05-13T05:22:13.440520Z"
},
"executionStartTime": 1690415954397,
"executionStopTime": 1690415954452,
"originalKey": "27f92d16-93c4-43bb-a37f-e7a1aeecd856",
"papermill": {
"duration": 0.083546,
"end_time": "2024-05-13T05:22:13.442335",
"exception": false,
"start_time": "2024-05-13T05:22:13.358789",
"status": "completed"
},
"requestMsgId": "07eba5ce-bebe-4588-8dbb-07553efeb2b0",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[WARNING 05-13 05:22:13] ax.service.utils.report_utils: Column reason missing for all trials. Not appending column.\n"
]
},
{
"data": {
"text/plain": [
"{'lr': 0.00031054584535304577, 'momentum': 0.665001895649106}"
]
},
"execution_count": 16,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df = ax_client.get_trials_data_frame()\n",
"best_arm_idx = df.trial_index[df[\"accuracy\"] == df[\"accuracy\"].max()].values[0]\n",
"best_arm = ax_client.get_trial_parameters(best_arm_idx)\n",
"best_arm"
]
},
{
"cell_type": "code",
"execution_count": 17,
"id": "8cdf96f7",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:13.559639Z",
"iopub.status.busy": "2024-05-13T05:22:13.559132Z",
"iopub.status.idle": "2024-05-13T05:22:13.563464Z",
"shell.execute_reply": "2024-05-13T05:22:13.562902Z"
},
"executionStartTime": 1690415954677,
"executionStopTime": 1690415954681,
"originalKey": "d0c7c645-c230-4654-a3b5-a01c61a09393",
"papermill": {
"duration": 0.064086,
"end_time": "2024-05-13T05:22:13.564717",
"exception": false,
"start_time": "2024-05-13T05:22:13.500631",
"status": "completed"
},
"requestMsgId": "0a962cef-65a1-4f95-9410-37a9a8e5c5ac",
"showInput": true,
"tags": []
},
"outputs": [],
"source": [
"combined_train_valid_set = torch.utils.data.ConcatDataset(\n",
" [\n",
" train_loader.dataset.dataset,\n",
" valid_loader.dataset.dataset,\n",
" ]\n",
")\n",
"combined_train_valid_loader = torch.utils.data.DataLoader(\n",
" combined_train_valid_set,\n",
" batch_size=BATCH_SIZE,\n",
" shuffle=True,\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 18,
"id": "2a8744c4",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:13.681951Z",
"iopub.status.busy": "2024-05-13T05:22:13.681419Z",
"iopub.status.idle": "2024-05-13T05:22:43.127141Z",
"shell.execute_reply": "2024-05-13T05:22:43.126469Z"
},
"executionStartTime": 1690415954791,
"executionStopTime": 1690416061340,
"originalKey": "5695c78b-4c6e-4d35-ab08-6c60781bd8f1",
"papermill": {
"duration": 29.506064,
"end_time": "2024-05-13T05:22:43.128802",
"exception": false,
"start_time": "2024-05-13T05:22:13.622738",
"status": "completed"
},
"requestMsgId": "e22fa0c7-88cc-4d8a-bb7d-4f96fbae9a42",
"showInput": true,
"tags": []
},
"outputs": [],
"source": [
"net = train(\n",
" net=CNN(),\n",
" train_loader=combined_train_valid_loader,\n",
" parameters=best_arm,\n",
" dtype=dtype,\n",
" device=device,\n",
")\n",
"test_accuracy = evaluate(\n",
" net=net,\n",
" data_loader=test_loader,\n",
" dtype=dtype,\n",
" device=device,\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 19,
"id": "91b0f0a5",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:43.246271Z",
"iopub.status.busy": "2024-05-13T05:22:43.245757Z",
"iopub.status.idle": "2024-05-13T05:22:43.249763Z",
"shell.execute_reply": "2024-05-13T05:22:43.249110Z"
},
"executionStartTime": 1690416061460,
"executionStopTime": 1690416061467,
"originalKey": "7522e229-9641-4383-a892-12c3f0a8011c",
"papermill": {
"duration": 0.064311,
"end_time": "2024-05-13T05:22:43.251106",
"exception": false,
"start_time": "2024-05-13T05:22:43.186795",
"status": "completed"
},
"requestMsgId": "5552d77d-9c9d-4712-9256-2cb3da836f2c",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Classification Accuracy (test set): 98.22%\n"
]
}
],
"source": [
"print(f\"Classification Accuracy (test set): {round(test_accuracy*100, 2)}%\")"
]
},
{
"cell_type": "markdown",
"id": "71efca0f",
"metadata": {
"customInput": null,
"originalKey": "c8232211-4837-4677-b86c-bce730635fff",
"papermill": {
"duration": 0.057973,
"end_time": "2024-05-13T05:22:43.367371",
"exception": false,
"start_time": "2024-05-13T05:22:43.309398",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"## 9. Save / reload optimization to JSON / SQL\n",
"We can serialize the state of optimization to JSON and save it to a `.json` file or save it to the SQL backend. For the former:"
]
},
{
"cell_type": "code",
"execution_count": 20,
"id": "1b559f84",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:43.484185Z",
"iopub.status.busy": "2024-05-13T05:22:43.483610Z",
"iopub.status.idle": "2024-05-13T05:22:43.510487Z",
"shell.execute_reply": "2024-05-13T05:22:43.509911Z"
},
"executionStartTime": 1690416061571,
"executionStopTime": 1690416061657,
"originalKey": "6afddb45-c980-4b14-b5e9-927747ea98ea",
"papermill": {
"duration": 0.086913,
"end_time": "2024-05-13T05:22:43.511777",
"exception": false,
"start_time": "2024-05-13T05:22:43.424864",
"status": "completed"
},
"requestMsgId": "bab02be8-706c-4422-b97b-c222b5084bba",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:43] ax.service.ax_client: Saved JSON-serialized state of optimization to `ax_client_snapshot.json`.\n"
]
}
],
"source": [
"ax_client.save_to_json_file() # For custom filepath, pass `filepath` argument."
]
},
{
"cell_type": "code",
"execution_count": 21,
"id": "e58e83bb",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:43.629985Z",
"iopub.status.busy": "2024-05-13T05:22:43.629480Z",
"iopub.status.idle": "2024-05-13T05:22:43.758087Z",
"shell.execute_reply": "2024-05-13T05:22:43.757387Z"
},
"executionStartTime": 1690416061758,
"executionStopTime": 1690416062132,
"originalKey": "31e6f7b4-cf6b-4967-95ff-f76d03657fb2",
"papermill": {
"duration": 0.189834,
"end_time": "2024-05-13T05:22:43.759553",
"exception": false,
"start_time": "2024-05-13T05:22:43.569719",
"status": "completed"
},
"requestMsgId": "f2d10848-f995-420d-88e7-9036894d7b1b",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:43] ax.service.ax_client: Starting optimization with verbose logging. To disable logging, set the `verbose_logging` argument to `False`. Note that float values in the logs are rounded to 6 decimal points.\n"
]
}
],
"source": [
"restored_ax_client = (\n",
" AxClient.load_from_json_file()\n",
") # For custom filepath, pass `filepath` argument."
]
},
{
"cell_type": "markdown",
"id": "abde618f",
"metadata": {
"customInput": null,
"originalKey": "122510f5-5b9e-4b1c-9f5e-8c8ea2e08848",
"papermill": {
"duration": 0.057583,
"end_time": "2024-05-13T05:22:43.875942",
"exception": false,
"start_time": "2024-05-13T05:22:43.818359",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"To store state of optimization to an SQL backend, first follow [setup instructions](https://ax.dev/docs/storage.html#sql) on Ax website."
]
},
{
"cell_type": "markdown",
"id": "e06125c0",
"metadata": {
"customInput": null,
"originalKey": "bd80e639-aa0f-4dc1-8542-0caf0d674fda",
"papermill": {
"duration": 0.05804,
"end_time": "2024-05-13T05:22:43.992232",
"exception": false,
"start_time": "2024-05-13T05:22:43.934192",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"Having set up the SQL backend, pass `DBSettings` to `AxClient` on instantiation (note that `SQLAlchemy` dependency will have to be installed – for installation, refer to [optional dependencies](https://ax.dev/docs/installation.html#optional-dependencies) on Ax website):"
]
},
{
"cell_type": "code",
"execution_count": 22,
"id": "5851a948",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:44.110188Z",
"iopub.status.busy": "2024-05-13T05:22:44.109668Z",
"iopub.status.idle": "2024-05-13T05:22:44.120053Z",
"shell.execute_reply": "2024-05-13T05:22:44.119534Z"
},
"executionStartTime": 1690416062222,
"executionStopTime": 1690416062314,
"originalKey": "80eb6a2e-6564-405e-b5d4-d448e32dbf60",
"papermill": {
"duration": 0.071101,
"end_time": "2024-05-13T05:22:44.121271",
"exception": false,
"start_time": "2024-05-13T05:22:44.050170",
"status": "completed"
},
"requestMsgId": "65f2307f-b800-4415-b9e7-11734a2a6889",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:44] ax.service.ax_client: Starting optimization with verbose logging. To disable logging, set the `verbose_logging` argument to `False`. Note that float values in the logs are rounded to 6 decimal points.\n"
]
}
],
"source": [
"from ax.storage.sqa_store.structs import DBSettings\n",
"\n",
"# URL is of the form \"dialect+driver://username:password@host:port/database\".\n",
"db_settings = DBSettings(url=\"sqlite:///foo.db\")\n",
"# Instead of URL, can provide a `creator function`; can specify custom encoders/decoders if necessary.\n",
"new_ax = AxClient(db_settings=db_settings)"
]
},
{
"cell_type": "markdown",
"id": "8388ee9b",
"metadata": {
"customInput": null,
"originalKey": "adafd3aa-b84e-4e86-9694-a29f94c6d5f3",
"papermill": {
"duration": 0.057589,
"end_time": "2024-05-13T05:22:44.236784",
"exception": false,
"start_time": "2024-05-13T05:22:44.179195",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"When valid `DBSettings` are passed into `AxClient`, a unique experiment name is a required argument (`name`) to `ax_client.create_experiment`. The **state of the optimization is auto-saved** any time it changes (i.e. a new trial is added or completed, etc). \n",
"\n",
"To reload an optimization state later, instantiate `AxClient` with the same `DBSettings` and use `ax_client.load_experiment_from_database(experiment_name=\"my_experiment\")`."
]
},
{
"cell_type": "markdown",
"id": "edd8a4f7",
"metadata": {
"customInput": null,
"originalKey": "2f4a875b-1e18-4352-955d-576d6b01c5ed",
"papermill": {
"duration": 0.057525,
"end_time": "2024-05-13T05:22:44.352272",
"exception": false,
"start_time": "2024-05-13T05:22:44.294747",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"# Special Cases"
]
},
{
"cell_type": "markdown",
"id": "01c9d333",
"metadata": {
"customInput": null,
"originalKey": "0d49e448-4768-401d-ac1d-810aee633c9a",
"papermill": {
"duration": 0.057521,
"end_time": "2024-05-13T05:22:44.467322",
"exception": false,
"start_time": "2024-05-13T05:22:44.409801",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"**Evaluation failure**: should any optimization iterations fail during evaluation, `log_trial_failure` will ensure that the same trial is not proposed again."
]
},
{
"cell_type": "code",
"execution_count": 23,
"id": "cc6fc8d1",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:44.584465Z",
"iopub.status.busy": "2024-05-13T05:22:44.583781Z",
"iopub.status.idle": "2024-05-13T05:22:45.404500Z",
"shell.execute_reply": "2024-05-13T05:22:45.403884Z"
},
"executionStartTime": 1690416062420,
"executionStopTime": 1690416064316,
"originalKey": "faa83f1d-31da-481a-96e4-ccbc12f30b91",
"papermill": {
"duration": 0.88101,
"end_time": "2024-05-13T05:22:45.406023",
"exception": false,
"start_time": "2024-05-13T05:22:44.525013",
"status": "completed"
},
"requestMsgId": "80a40c3a-76ed-4e1d-aa77-3652fadbe69f",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.service.ax_client: Generated new trial 26 with parameters {'lr': 7.7e-05, 'momentum': 0.643066} using model BoTorch.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.service.ax_client: Registered failure of trial 26.\n"
]
}
],
"source": [
"_, trial_index = ax_client.get_next_trial()\n",
"ax_client.log_trial_failure(trial_index=trial_index)"
]
},
{
"cell_type": "markdown",
"id": "e48b34f7",
"metadata": {
"customInput": null,
"originalKey": "c826a96e-9431-49bd-87d7-62b517537a15",
"papermill": {
"duration": 0.057858,
"end_time": "2024-05-13T05:22:45.522557",
"exception": false,
"start_time": "2024-05-13T05:22:45.464699",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"**Need to run many trials in parallel**: for optimal results and optimization efficiency, we strongly recommend sequential optimization (generating a few trials, then waiting for them to be completed with evaluation data). However, if your use case needs to dispatch many trials in parallel before they are updated with data and you are running into the *\"All trials for current model have been generated, but not enough data has been observed to fit next model\"* error, instantiate `AxClient` as `AxClient(enforce_sequential_optimization=False)`."
]
},
{
"cell_type": "markdown",
"id": "7293463b",
"metadata": {
"customInput": null,
"originalKey": "683378e0-893b-49a1-b090-084dc394da1a",
"papermill": {
"duration": 0.057463,
"end_time": "2024-05-13T05:22:45.637658",
"exception": false,
"start_time": "2024-05-13T05:22:45.580195",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"# Service API Exceptions Meaning and Handling\n",
"[**`DataRequiredError`**](https://ax.dev/api/exceptions.html#ax.exceptions.core.DataRequiredError): Ax generation strategy needs to be updated with more data to proceed to the next optimization model. When the optimization moves from initialization stage to the Bayesian optimization stage, the underlying BayesOpt model needs sufficient data to train. For optimal results and optimization efficiency (finding the optimal point in the least number of trials), we recommend sequential optimization (generating a few trials, then waiting for them to be completed with evaluation data). Therefore, the correct way to handle this exception is to wait until more trial evaluations complete and log their data via `ax_client.complete_trial(...)`. \n",
"\n",
"However, if there is strong need to generate more trials before more data is available, instantiate `AxClient` as `AxClient(enforce_sequential_optimization=False)`. With this setting, as many trials will be generated from the initialization stage as requested, and the optimization will move to the BayesOpt stage whenever enough trials are completed."
]
},
{
"cell_type": "markdown",
"id": "bdc872a0",
"metadata": {
"customInput": null,
"originalKey": "4602d41d-43aa-46d2-9ca6-392c414d0b5f",
"papermill": {
"duration": 0.05788,
"end_time": "2024-05-13T05:22:45.753893",
"exception": false,
"start_time": "2024-05-13T05:22:45.696013",
"status": "completed"
},
"showInput": false,
"tags": []
},
"source": [
"[**`MaxParallelismReachedException`**](https://ax.dev/api/modelbridge.html#ax.modelbridge.generation_strategy.MaxParallelismReachedException): generation strategy restricts the number of trials that can be run simultaneously (to encourage sequential optimization), and the parallelism limit has been reached. The correct way to handle this exception is the same as `DataRequiredError` – to wait until more trial evluations complete and log their data via `ax_client.complete_trial(...)`.\n",
" \n",
"In some cases higher parallelism is important, so `enforce_sequential_optimization=False` kwarg to AxClient allows the user to suppress limiting of parallelism. It's also possible to override the default parallelism setting for all stages of the optimization by passing `choose_generation_strategy_kwargs` to `ax_client.create_experiment`:"
]
},
{
"cell_type": "code",
"execution_count": 24,
"id": "6b7a6a9e",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:45.873899Z",
"iopub.status.busy": "2024-05-13T05:22:45.873255Z",
"iopub.status.idle": "2024-05-13T05:22:45.884489Z",
"shell.execute_reply": "2024-05-13T05:22:45.883862Z"
},
"executionStartTime": 1690416064534,
"executionStopTime": 1690416064564,
"originalKey": "d62e6cfd-5127-450e-80b7-d0edcaf97d6c",
"papermill": {
"duration": 0.072764,
"end_time": "2024-05-13T05:22:45.885890",
"exception": false,
"start_time": "2024-05-13T05:22:45.813126",
"status": "completed"
},
"requestMsgId": "cb9a17f9-5734-41c6-9018-c0635c61d8b3",
"showInput": true,
"tags": []
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.service.ax_client: Starting optimization with verbose logging. To disable logging, set the `verbose_logging` argument to `False`. Note that float values in the logs are rounded to 6 decimal points.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.service.utils.instantiation: Inferred value type of ParameterType.FLOAT for parameter x. If that is not the expected value type, you can explicitly specify 'value_type' ('int', 'float', 'bool' or 'str') in parameter dict.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.service.utils.instantiation: Inferred value type of ParameterType.FLOAT for parameter y. If that is not the expected value type, you can explicitly specify 'value_type' ('int', 'float', 'bool' or 'str') in parameter dict.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.service.utils.instantiation: Created search space: SearchSpace(parameters=[RangeParameter(name='x', parameter_type=FLOAT, range=[-5.0, 10.0]), RangeParameter(name='y', parameter_type=FLOAT, range=[0.0, 15.0])], parameter_constraints=[]).\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.modelbridge.dispatch_utils: Using Models.BOTORCH_MODULAR since there is at least one ordered parameter and there are no unordered categorical parameters.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.modelbridge.dispatch_utils: Calculating the number of remaining initialization trials based on num_initialization_trials=None max_initialization_trials=None num_tunable_parameters=2 num_trials=None use_batch_trials=False\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.modelbridge.dispatch_utils: calculated num_initialization_trials=5\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.modelbridge.dispatch_utils: num_completed_initialization_trials=0 num_remaining_initialization_trials=5\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.modelbridge.dispatch_utils: `verbose`, `disable_progbar`, and `jit_compile` are not yet supported when using `choose_generation_strategy` with ModularBoTorchModel, dropping these arguments.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"[INFO 05-13 05:22:45] ax.modelbridge.dispatch_utils: Using Bayesian Optimization generation strategy: GenerationStrategy(name='Sobol+BoTorch', steps=[Sobol for 5 trials, BoTorch for subsequent trials]). Iterations after 5 will take longer to generate due to model-fitting.\n"
]
}
],
"source": [
"ax_client = AxClient()\n",
"ax_client.create_experiment(\n",
" parameters=[\n",
" {\"name\": \"x\", \"type\": \"range\", \"bounds\": [-5.0, 10.0]},\n",
" {\"name\": \"y\", \"type\": \"range\", \"bounds\": [0.0, 15.0]},\n",
" ],\n",
" # Sets max parallelism to 10 for all steps of the generation strategy.\n",
" choose_generation_strategy_kwargs={\"max_parallelism_override\": 10},\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 25,
"id": "c0afe95d",
"metadata": {
"customInput": null,
"customOutput": null,
"execution": {
"iopub.execute_input": "2024-05-13T05:22:46.006374Z",
"iopub.status.busy": "2024-05-13T05:22:46.006039Z",
"iopub.status.idle": "2024-05-13T05:22:46.010722Z",
"shell.execute_reply": "2024-05-13T05:22:46.010184Z"
},
"executionStartTime": 1690416064679,
"executionStopTime": 1690416064702,
"originalKey": "bc15d2cf-8ddc-4d66-83b6-7469cd15aa4d",
"papermill": {
"duration": 0.066723,
"end_time": "2024-05-13T05:22:46.012061",
"exception": false,
"start_time": "2024-05-13T05:22:45.945338",
"status": "completed"
},
"requestMsgId": "996c4bd3-b296-4cf9-8f95-cbf488639c2f",
"showInput": true,
"tags": []
},
"outputs": [
{
"data": {
"text/plain": [
"[(5, 10), (-1, 10)]"
]
},
"execution_count": 25,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"ax_client.get_max_parallelism() # Max parallelism is now 10 for all stages of the optimization."
]
}
],
"metadata": {
"fileHeader": "",
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.10.14"
},
"papermill": {
"default_parameters": {},
"duration": 236.079303,
"end_time": "2024-05-13T05:22:48.825652",
"environment_variables": {},
"exception": null,
"input_path": "/tmp/tmp.gf1AMIEaOC/Ax-main/tutorials/tune_cnn_service.ipynb",
"output_path": "/tmp/tmp.gf1AMIEaOC/Ax-main/tutorials/tune_cnn_service.ipynb",
"parameters": {},
"start_time": "2024-05-13T05:18:52.746349",
"version": "2.6.0"
}
},
"nbformat": 4,
"nbformat_minor": 5
}