Labs 0, 1

labs/PiDay-2022-Vision/Lab-0-intro.md

@@ -3,44 +3,40 @@
 
 ## Introduction
 
-OCI Vision is a serverless, multi-tenant cloud service, accessible using the Console, over REST APIs, or via programming language SDKs. It detects and classifies objects in images. Batches of images can be processed using asynchronous API endpoints.
+This lab is built for use as a workshop at the Oracle Pi Day event in March 2022. It uses Oracle Cloud Infrastructure (OCI) Vision service to show how AI services can be used with applications. The workshop guides the user to run a safety application that that looks for persons not wearing hardhats in images of industrial scenes.
 
-OCI Vision features are  split between Document AI for document-centric images and Image Analysis
-for object and scene-based images.
-
-*Estimated Workshop Time*: 90 minutes
-
-### Objectives
-
-In this workshop, you will:
-
-* Get familiar with the OCI console and be able to demo key vision features with it
-* Learn how to train an image classification or object detection model through the OCI console
-* Learn how to use REST API to communicate with our vision service endpoints.
+OCI Vision is a serverless, multi-tenant cloud service, accessible using the Console, over REST APIs, or via programming language SDKs. It detects and classifies objects in images. Batches of images can be processed using asynchronous API endpoints. OCI Vision features include both document AI for document-centric images and image analysis for object and scene-based images. This lab focuses on image analysis.
 
 ### 1. Image Analysis
 
-* Object Detection is a fundamental image analysis feature. You can detect and locate the objects in an image. For example, the image is of a living room, Vision locates the objects therein, such as a chair, a sofa, and a TV. It then draws bounding boxes around the objects and identifies them. You can also use it for visual anomaly detection.
-* Image Classification is a fundamental image analysis feature. Upload an image to Object Storage and you can put it in pre-determined classes, based on the objects within it.
+* Object Detection is an image analysis feature that detects and locates the objects in an image. For example, if the image is of a living room, Vision locates the objects therein, such as a chair, a sofa, and a TV. It then draws bounding boxes around the objects and identifies them. It can also be used for visual anomaly detection by training it to detect anomalous objects in images.
+* Image Classification is an image analysis feature that puts images in pre-determined classes, based on the objects within it.
 
 ### 2. Document AI
 
-* Text Recognition (also known as Optical Character Recognition) means Vision can detect and recognize text in a document. Vision draws bounding boxes around the printed or hand-written text it locates in an image, and digitizes the text.
-* Document classification: OCI Vision can classify a document, for example, whether the document is a tax form, an invoice, or a receipt.
-* Language classification: OCI Vision detects the language of document based on visual features.
-* Table extraction: OCI Vision extracts content in tabular format, maintaining row/column relationships of cells.
+* Text Recognition (also known as Optical Character Recognition) means Vision can detect and recognize text in a document. Vision draws bounding boxes around the printed or hand-written text it locates in an image, and digitizes the text
+* Document classification determines the type of document, such as a tax form, an invoice, or a receipt
+* Language classification detects the language of document based on visual features
+* Table extraction extracts content in tabular format, maintaining row/column relationships of cells.
 
 Document AI is a key building block for scenarios like business process automation (also called RPA for Robotic Process Automation), automated receipt processing, semantic search, and the automatic extraction of information from unstructured content like scanned documents.
 
-Custom model training lets you tailor base models (through transfer learning approaches) to make deep learning models tuned to your data. Model selection, resource planning, and deployment are all managed by Vision.
+Custom model training tailors base models (through transfer learning approaches) to make deep learning models tuned to the training data. Model selection, resource planning, and deployment are all managed by Vision.
 
-In order to view in the console and complete the following labs, you can check the Get Started section [here](https://preview.content.oci.oracleiaas.com/en-us/iaas/vision/vision/using/home.htm?bundle=8941).
+*Estimated Workshop Time*: 90 minutes
+
+### Objectives
+
+In this workshop, you will:
+
+* Configure an OCI tenancy for OCI Vision
+* Get familiar with the OCI console and exercise OCI Vision features with it
+* Learn how to use REST API to communicate with OCI vision endpoints
+* Execute a sample application that processes a batch of images using object detection
+* Learn how to train an image classification or object detection model through the OCI console
 
 ### Prerequisites
-* An Oracle Trial Account or Paid Cloud Account
-* Additional prerequisites (cloud services) are mentioned per lab
-* Familiar with Python programming is recommended.
-* Python environment (todo)
-* Postman (todo)
+  - None
+  - Familiar with Python programming is recommended.
 
 [Proceed to the next lab](#next).

labs/PiDay-2022-Vision/Lab-1-tenancy-access.md

@@ -73,7 +73,7 @@ If you already have a cloud account with unused cloud credits, skip to **Task 2*
 ## **TASK 2:** Sign in to Your Account
 When you sign up for an Oracle Cloud account, a user is created for you in Oracle Identity Cloud Service with the username and password you selected at sign up. You can use this single sign-on option to sign in to Oracle Cloud Infrastructure and then navigate to other Oracle Cloud services without reauthenticating. This user has administrator privileges for all the Oracle Cloud services included with your account.
 
-1. Use the account access **link in your confirmation email** (this provides a shortcut to the sign-in for your account and region).  Enter your user name and password and click **Sign In**. Your username is your email address. The password is what you chose when you signed up for an account.
+1. Use the **account access link in your confirmation email** (this provides a shortcut to the sign-in for your account and region).  Enter your user name and password and click **Sign In**. Your username is your email address. The password is what you chose when you signed up for an account.
 
   ![](images/direct-sign-in.png)