From 78a83be67ea61685406c75f633e528806f60f359 Mon Sep 17 00:00:00 2001
From: ovalle15 <aovalle@Andreas-MacBook-Pro-2.local>
Date: Tue, 8 Aug 2023 13:23:08 -0400
Subject: [PATCH 1/4] Updates to project notebook and delete labels notebook

---
 examples/basics/labels.ipynb   | 308 ---------------------------------
 examples/basics/projects.ipynb |  80 ++++++---
 2 files changed, 55 insertions(+), 333 deletions(-)
 delete mode 100644 examples/basics/labels.ipynb

diff --git a/examples/basics/labels.ipynb b/examples/basics/labels.ipynb
deleted file mode 100644
index 63371079e..000000000
--- a/examples/basics/labels.ipynb
+++ /dev/null
@@ -1,308 +0,0 @@
-{
-  "nbformat": 4,
-  "nbformat_minor": 5,
-  "metadata": {},
-  "cells": [
-    {
-      "metadata": {},
-      "source": [
-        "<td>\n",
-        "   <a target=\"_blank\" href=\"https://labelbox.com\" ><img src=\"https://labelbox.com/blog/content/images/2021/02/logo-v4.svg\" width=256/></a>\n",
-        "</td>"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "<td>\n",
-        "<a href=\"https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/labels.ipynb\" target=\"_blank\"><img\n",
-        "src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"></a>\n",
-        "</td>\n",
-        "\n",
-        "<td>\n",
-        "<a href=\"https://github.com/Labelbox/labelbox-python/tree/master/examples/basics/labels.ipynb\" target=\"_blank\"><img\n",
-        "src=\"https://img.shields.io/badge/GitHub-100000?logo=github&logoColor=white\" alt=\"GitHub\"></a>\n",
-        "</td>"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# Labels"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "#### *** This section explains how to use the Label object but It is reccomended that you use bulk export for exporting labels *** \n",
-        "* [Export data](https://github.com/Labelbox/labelbox-python/tree/master/examples/basics/export_data.ipynb)\n",
-        "* [Label format documentation](https://docs.labelbox.com/data-model/en/index-en#label)"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "!pip install labelbox"
-      ],
-      "cell_type": "code",
-      "outputs": [],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "import labelbox as lb\n",
-        "import json\n",
-        "import os"
-      ],
-      "cell_type": "code",
-      "outputs": [],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "* Set the following cell with your data to run this notebook"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# Pick a project that has labels\n",
-        "PROJECT_ID = \"ckmdx02yhzsrt0757owj3aprx\""
-      ],
-      "cell_type": "code",
-      "outputs": [],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# API Key and Client\n",
-        "Provide a valid api key below in order to properly connect to the Labelbox Client."
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# Add your api key\n",
-        "API_KEY = None\n",
-        "client = lb.Client(api_key=API_KEY)\n",
-        "project = client.get_project(PROJECT_ID)"
-      ],
-      "cell_type": "code",
-      "outputs": [],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "### Read"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# Use relationship to get labels\n",
-        "labels = project.labels()"
-      ],
-      "cell_type": "code",
-      "outputs": [],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# Get the first label in the dataset\n",
-        "label = next(labels)"
-      ],
-      "cell_type": "code",
-      "outputs": [],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "label"
-      ],
-      "cell_type": "code",
-      "outputs": [
-        {
-          "data": {
-            "text/plain": [
-              "<Label ID: ckmg5x88300003g68852nkn25>"
-            ]
-          },
-          "execution_count": 5,
-          "metadata": {},
-          "output_type": "execute_result"
-        }
-      ],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# Json result\n",
-        "print(label.seconds_to_label)\n",
-        "# Print first annotation\n",
-        "json.loads(label.label)['objects'][0]\n",
-        "# ... any other field supported by a Label"
-      ],
-      "cell_type": "code",
-      "outputs": [
-        {
-          "name": "stdout",
-          "output_type": "stream",
-          "text": [
-            "185.006\n"
-          ]
-        },
-        {
-          "data": {
-            "text/plain": [
-              "{'featureId': 'ckmdx6h0x0h180z9varaf3y0l',\n",
-              " 'schemaId': 'ckmdx04do1q3p0y820v1jd5wt',\n",
-              " 'title': 'handbag',\n",
-              " 'value': 'handbag',\n",
-              " 'color': '#7f00ff',\n",
-              " 'point': {'x': 502, 'y': 1400},\n",
-              " 'instanceURI': 'https://api.labelbox.com/masks/feature/ckmdx6h0x0h180z9varaf3y0l'}"
-            ]
-          },
-          "execution_count": 15,
-          "metadata": {},
-          "output_type": "execute_result"
-        }
-      ],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "See all available fields [here](https://github.com/Labelbox/labelbox-python/blob/develop/labelbox/schema/label.py)"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "### Create"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "* Create is not supported from the api.\n",
-        "* See model assisted upload tutorials for attaching labels to a project"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "### Update\n",
-        "* We can create reviews and benchmarks for a label"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "#### Review\n",
-        "label.create_review(score=1)"
-      ],
-      "cell_type": "code",
-      "outputs": [
-        {
-          "data": {
-            "text/plain": [
-              "<Review ID: ckmgdwxs30f470y3gapih1cxs>"
-            ]
-          },
-          "execution_count": 21,
-          "metadata": {},
-          "output_type": "execute_result"
-        }
-      ],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "next(label.reviews()).score"
-      ],
-      "cell_type": "code",
-      "outputs": [
-        {
-          "data": {
-            "text/plain": [
-              "1"
-            ]
-          },
-          "execution_count": 25,
-          "metadata": {},
-          "output_type": "execute_result"
-        }
-      ],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "# We also can set this label to be a benchmark\n",
-        "# Labelers will be compared against this label to determine if they are properly trained\n",
-        "label.create_benchmark()"
-      ],
-      "cell_type": "code",
-      "outputs": [
-        {
-          "data": {
-            "text/plain": [
-              "<Benchmark ID: ckmgdyyw5b26b07600nz25i1y>"
-            ]
-          },
-          "execution_count": 27,
-          "metadata": {},
-          "output_type": "execute_result"
-        }
-      ],
-      "execution_count": null
-    },
-    {
-      "metadata": {},
-      "source": [
-        "### Delete"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "* Grab a list of labels\n",
-        "* Either a whole project worth\n",
-        "```labels = list(project.labels())```\n",
-        "* Or a custom set of labels and bulk delete\n",
-        "* ```Label.bulk_delete([labels])```"
-      ],
-      "cell_type": "markdown"
-    },
-    {
-      "metadata": {},
-      "source": [
-        "* Delete a single label with the following\n",
-        "* `label.delete()` \n",
-        "* This is not reccomended unless you are only deleting a handful. Otherwise use bulk_delete"
-      ],
-      "cell_type": "markdown"
-    }
-  ]
-}
\ No newline at end of file
diff --git a/examples/basics/projects.ipynb b/examples/basics/projects.ipynb
index d9cb04b35..a8ffa87c9 100644
--- a/examples/basics/projects.ipynb
+++ b/examples/basics/projects.ipynb
@@ -38,11 +38,9 @@
       "metadata": {},
       "source": [
         "* A project can be thought of as a specific labeling task on a set of labels\n",
-        "* That set of labels is defined by the datasets attached to the project\n",
-        "    - Those datasets have data rows which is what is being labeled\n",
-        "* Each project has an ontology which defines the types of annotations supported during this labeling pass\n",
-        "\n",
-        "** Note that there is a lot of advanced usage that is not covered in this notebook. See project_setup for those functions.\n",
+        "* That set of labels is defined by the data rows attached to the project\n",
+        "* Each project has an ontology which defines the types of annotations supported during the labeling process\n",
+        "**Note that there is a lot of advanced usage that is not covered in this notebook. See examples/project_configuration/project_setup.ipynb for those functions**\n",
         "* Also note that deprecated functions are not explained here."
       ],
       "cell_type": "markdown"
@@ -50,7 +48,7 @@
     {
       "metadata": {},
       "source": [
-        "!pip install labelbox"
+        "!pip install labelbox -q"
       ],
       "cell_type": "code",
       "outputs": [],
@@ -60,7 +58,8 @@
       "metadata": {},
       "source": [
         "import labelbox as lb\n",
-        "import os"
+        "import os\n",
+        "import uuid"
       ],
       "cell_type": "code",
       "outputs": [],
@@ -78,7 +77,7 @@
       "metadata": {},
       "source": [
         "# Add your api key\n",
-        "API_KEY = None\n",
+        "API_KEY = \"\"\n",
         "client = lb.Client(api_key=API_KEY)"
       ],
       "cell_type": "code",
@@ -88,7 +87,7 @@
     {
       "metadata": {},
       "source": [
-        "### Create\n"
+        "### Create a project\n"
       ],
       "cell_type": "markdown"
     },
@@ -107,21 +106,30 @@
     {
       "metadata": {},
       "source": [
-        "### Read"
+        "### Create a dataset with data rows"
       ],
       "cell_type": "markdown"
     },
     {
       "metadata": {},
       "source": [
-        "# Note the project is not setup (so a lot of these fiels are empty). Follow the project setup workflow\n",
-        "print(\"Project is not setup yet:\", project.setup_complete is None)\n",
-        "print(\"Project name:\", project.name)\n",
-        "print(\"Project description:\", project.description)\n",
-        "print(\"Media Type:\", project.media_type)\n",
-        "print(\"Dataset:\", list(project.datasets()))\n",
-        "print(\"Ontology:\", project.ontology().normalized)\n",
-        "print(\"Benchmarks:\", project.benchmarks())"
+        "# Attach dataset\n",
+        "dataset = client.create_dataset(name=\"project-demo-dataset\")\n",
+        "global_keys = []\n",
+        "uploads = []\n",
+        "# Generate data rows\n",
+        "for i in range(1,9):\n",
+        "    gb_key = \"TEST-ID-%id\" % uuid.uuid1()\n",
+        "    uploads.append({\n",
+        "        'row_data':  f\"https://storage.googleapis.com/labelbox-datasets/People_Clothing_Segmentation/jpeg_images/IMAGES/img_000{i}.jpeg\",\n",
+        "        \"global_key\": gb_key,\n",
+        "    })\n",
+        "    global_keys.append(gb_key)\n",
+        "\n",
+        "task = dataset.create_data_rows(uploads)\n",
+        "task.wait_till_done()\n",
+        "print(\"ERRORS: \" , task.errors)\n",
+        "print(\"RESULT URL: \", task.result_url)"
       ],
       "cell_type": "code",
       "outputs": [],
@@ -130,19 +138,41 @@
     {
       "metadata": {},
       "source": [
-        "### Update\n",
-        "\n"
+        "### Add a data rows to a project \n"
       ],
       "cell_type": "markdown"
     },
     {
       "metadata": {},
       "source": [
-        "# Attach dataset\n",
-        "ds = client.create_dataset(name=\"test-ds\")\n",
-        "project.datasets.connect(ds)\n",
-        "print([ds.name for ds in project.datasets()])\n",
-        "ds.delete()"
+        "project.create_batch(\n",
+        "  \"project-demo\", # each batch in a project must have a unique name\n",
+        "  global_keys=global_keys,  # paginated collection of data row objects, list of data row ids or global keys\n",
+        "  priority=1 # priority between 1(highest) - 5(lowest)\n",
+        ")"
+      ],
+      "cell_type": "code",
+      "outputs": [],
+      "execution_count": null
+    },
+    {
+      "metadata": {},
+      "source": [
+        "### Fetch project configuration"
+      ],
+      "cell_type": "markdown"
+    },
+    {
+      "metadata": {},
+      "source": [
+        "# Note the project is not fully setup many of the fields will be empty. \n",
+        "print(\"Project is not setup yet:\", project.setup_complete is None)\n",
+        "print(\"Project name:\", project.name)\n",
+        "print(\"Project description:\", project.description)\n",
+        "print(\"Media Type:\", project.media_type)\n",
+        "batches = [b for b in project.batches()]\n",
+        "print(\"Project Batches\", batches)\n",
+        "print(\"Ontology:\", project.ontology())"
       ],
       "cell_type": "code",
       "outputs": [],

From bcc0930346ac04a756c979c5de44152f9926c3f6 Mon Sep 17 00:00:00 2001
From: ovalle15 <aovalle@Andreas-MacBook-Pro-2.local>
Date: Tue, 8 Aug 2023 13:25:09 -0400
Subject: [PATCH 2/4] Update Readme

---
 examples/README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/examples/README.md b/examples/README.md
index 5eef064f3..33841db05 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -15,7 +15,6 @@
 | Data Row Metadata | [Github](basics/data_row_metadata.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/data_row_metadata.ipynb) |
 | Datasets          | [Github](basics/datasets.ipynb)          | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/datasets.ipynb)          |
 | Export data       | [Github](basics/export_data.ipynb)       | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/export_data.ipynb)       |
-| Labels            | [Github](basics/labels.ipynb)            | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/labels.ipynb)            |
 | Ontologies        | [Github](basics/ontologies.ipynb)        | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/ontologies.ipynb)        |
 | Projects          | [Github](basics/projects.ipynb)          | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/projects.ipynb)          |
 | User Management   | [Github](basics/user_management.ipynb)   | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Labelbox/labelbox-python/blob/master/examples/basics/user_management.ipynb)   |

From f65f842650da7fdac70d0460f43d809d00ad29d0 Mon Sep 17 00:00:00 2001
From: ovalle15 <aovalle@Andreas-MacBook-Pro-2.local>
Date: Wed, 9 Aug 2023 10:54:43 -0400
Subject: [PATCH 3/4] comment out project.delete()

---
 examples/basics/projects.ipynb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/basics/projects.ipynb b/examples/basics/projects.ipynb
index a8ffa87c9..60a1ab7d4 100644
--- a/examples/basics/projects.ipynb
+++ b/examples/basics/projects.ipynb
@@ -188,7 +188,7 @@
     {
       "metadata": {},
       "source": [
-        "project.delete()"
+        "# project.delete()"
       ],
       "cell_type": "code",
       "outputs": [],

From 33489ea71c087af8ff61389b256fa4bda90c6bc9 Mon Sep 17 00:00:00 2001
From: ovalle15 <aovalle@Andreas-MacBook-Pro-2.local>
Date: Wed, 9 Aug 2023 10:56:57 -0400
Subject: [PATCH 4/4] remove add dataset comment

---
 examples/basics/projects.ipynb | 1 -
 1 file changed, 1 deletion(-)

diff --git a/examples/basics/projects.ipynb b/examples/basics/projects.ipynb
index 60a1ab7d4..28b570270 100644
--- a/examples/basics/projects.ipynb
+++ b/examples/basics/projects.ipynb
@@ -113,7 +113,6 @@
     {
       "metadata": {},
       "source": [
-        "# Attach dataset\n",
         "dataset = client.create_dataset(name=\"project-demo-dataset\")\n",
         "global_keys = []\n",
         "uploads = []\n",