# Quick start: Analyze data in a Jupyter notebook #

You can create a notebook in which you run code to prepare, visualize, and analyze data, or build and train a model\. Read about Jupyter notebooks, then watch a video and take a tutorial that’s suitable for users with some knowledge of Python code\.

Your basic workflow includes these tasks:

<!-- <ol> -->

1.  Open your sandbox project\. Projects are where you can collaborate with others to work with data\.
2.  Add your data to the project\. You can add CSV files or data from a remote data source through a connection\.
3.  Create a notebook in the project\.
4.  Add code to the notebook to load and analyze your data\.
5.  Run your notebook and share the results with your colleagues\.

<!-- </ol> -->

## Read about notebooks ##

A Jupyter notebook is a web\-based environment for interactive computing\. You can run small pieces of code that process your data, and you can immediately view the results of your computation\. Notebooks include all of the building blocks you need to work with data:

<!-- <ul> -->

 *  The data
 *  The code computations that process the data
 *  Visualizations of the results
 *  Text and rich media to enhance understanding

<!-- </ul> -->

[Read more about notebooks](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/notebook-editor.html)

## Watch a video about notebooks ##

![Watch Video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) Watch this video to learn the basics of Jupyter notebooks\.

This video provides a visual method to learn the concepts and tasks in this documentation\.

## Try a tutorial to create a notebook ##

In this tutorial, you will complete these tasks:

<!-- <ul> -->

 *  [Task 1: Open a project\.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#step01)
 *  [Task 2: Add a notebook to your project\.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#step02)
 *  [Task 3: Load a file and save the notebook\.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#step03)
 *  [Task 4: Find and edit the notebook\.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#step04)
 *  [Task 5: Share read\-only version of the notebook\.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#step05)
 *  [Task 6: Schedule a notebook to run at a different time\.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#step06)

<!-- </ul> -->

This tutorial will take approximately 15 minutes to complete\.

Expand all sections

<!-- <ul> -->

 *  Tips for completing this tutorial
    
    \#\#\# Use the video picture-in-picture Tip: Start the video, then as you scroll through the tutorial, the video moves to picture-in-picture mode. Close the video table of contents for the best experience with picture-in-picture. You can use picture-in-picture mode so you can follow the video as you complete the tasks in this tutorial. Click the timestamps for each task to follow along.The following animated image shows how to use the video picture-in-picture and table of contents features: ![How to use picture-in-picture and chapters](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/pip-and-chapters.gif)\{: width="560px" height="315px" data-tearsheet="this"\} \#\#\# Get help in the community If you need help with this tutorial, you can ask a question or find an answer in the [Cloud Pak for Data Community discussion forum](https://community.ibm.com/community/user/cloudpakfordata/communities/community-home/digestviewer?communitykey=c0c16ff2-10ef-4b50-ae4c-57d769937235)\{: new\_window\}. \#\#\# Set up your browser windows For the optimal experience completing this tutorial, open Cloud Pak for Data in one browser window, and keep this tutorial page open in another browser window to switch easily between the two applications. Consider arranging the two browser windows side-by-side to make it easier to follow along. ![Side-by-side tutorial and UI](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/tutorial-side-by-side.png)\{: width="560px" height="315px" data-tearsheet="this"\} Tip: If you encounter a guided tour while completing this tutorial in the user interface, click **Maybe later**.  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

<!-- <ul> -->

 *  Task 1: Open a project
    
    You need a project to store the notebook and data asset. You can use your sandbox project or create a project. Follow these steps to open a project and add a data asset to the project: 1. From the navigation menu ![Navigation menu](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/navigation-menu.svg)\{: iih\}, choose **Projects > View all projects** 1. Open your sandbox project. If you want to use a new project: 1. Click **New project**. 1. Select **Create an empty project**. 1. Enter a name and optional description for the project. 1. Choose an existing [object storage service instance](https://dataplatform.cloud.ibm.com/docs/content/wsj/admin/storage-options.html)\{: new\_window\} or create a new one. 1. Click **Create**. 1. From the navigation menu, click **Samples**. 1. Search for an interesting data set, and select the data set. 1. Click **Add to project**. 1. Select the project from the list, and click **Add**. 1. After the data set is added, click **View Project**. 1. In the project, click the **Assets** tab to see the data set. For more information, see [Creating a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/projects.html)\{: new\_window\}.  
    \#\#\# ![Checkpoint icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/checkmark--filled-blue.svg)\{: iih\} Check your progress The following image shows the Assets tab in the project.  
      
    ![The following image shows the Assets tab in the project.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-assets-tab-01.png)\{: width="100%" \}  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

<!-- <ul> -->

 *  Task 2: Add a notebook to your project
    
    ![preview tutorial video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) To preview this task, watch the video beginning at 00:06. Follow these steps to create a new notebook in your project. 1. In your project, on the *Assets* tab, click **New asset > Work with data and models in Python or R notebooks**. 1. Type a name and description (optional). 1. Select a runtime environment for this notebook. 1. Click **Create**. Wait for the notebook editor to load. \#\#\# ![Checkpoint icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/checkmark--filled-blue.svg)\{: iih\} Check your progress The following image shows blank notebook.  
      
    ![The following image shows the blank notebook.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-editor.png)\{: width="100%" \}  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

<!-- <ul> -->

 *  Task 3: Load a file and save the notebook
    
    ![preview tutorial video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) To preview this task, watch the video beginning at 00:23. Now you can access the data asset in your notebook that you uploaded to your project earlier. Follow these steps to load data into a data frame: 1. Click in an empty code cell in your notebook. 1. Click the **Code snippets** icon ( ![the Code snippets icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/images/code-snippets-icon.png)\{: iih\}). 1. In the side pane, click **Read data**. 1. Click **Select data from project**. 1. Locate the data asset from the project, and click **Select**. 1. In the *Load as* drop-down list, select the load option that you prefer. 1. Click **Insert code to cell**. The code to read and load the data asset is inserted into the cell. 1. Click **Run** to run your code. The first few rows of your data set will display. 1. To save a version of your notebook, click **File > Save Version**. You can also just save your notebook with **File > Save**. \#\#\# ![Checkpoint icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/checkmark--filled-blue.svg)\{: iih\} Check your progress The following image shows the notebook with the pandas DataFrame.  
      
    ![The following image shows the notebook with the pandas DataFrame.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-cell01.png)\{: width="100%" \}  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

<!-- <ul> -->

 *  Task 4: Find and edit the notebook
    
    ![preview tutorial video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) To preview this task, watch the video beginning at 01:19. Follow these steps to locate the saved notebook on the Assets tab, and edit the notebook: 1. In the project navigation trail, click your project name to return to your project. 1. Click the **Assets** tab to find the notebook. 1. When you click the notebook, it will open in `READ ONLY` mode. 1. To edit the notebook, click the **pencil** icon ![Pencil icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/edit.svg)\{: iih\}. 1. Click the **Information** icon ![Information icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/information.svg)\{: iih\} to open the *Information* panel. 1. On the *General* tab, edit the name and description of the notebook. 1. Click the **Environment** tab to see how you can change the environment used to run the notebook or update the runtime status to either stop and restart. \#\#\# ![Checkpoint icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/checkmark--filled-blue.svg)\{: iih\} Check your progress The following image shows the notebook with the Information panel displayed.  
      
    ![The following image shows the notebook with the Information panel displayed.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-environment.png)\{: width="100%" \}  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

<!-- <ul> -->

 *  Task 5: Share read\-only version of the notebook
    
    ![preview tutorial video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) To preview this task, watch the video beginning at 01:52. Follow these steps to create a link to the notebook to share with colleagues: 1. Click the **Share** icon ![Share icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/share.svg)\{: iih\} if you would like to share the read-only view of the notebook. 1. Click to turn on the **Share with anyone who has the link** toggle button. 1. Select what content you would like to share through a link or social media. 1. Click the **Copy** icon ![Copy icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/copy.svg)\{: iih\} to copy a direct link to this notebook. 1. Click **Close**. \#\#\# ![Checkpoint icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/checkmark--filled-blue.svg)\{: iih\} Check your progress The following image shows the Share dialog box.  
      
    ![The following image shows the Share dialog box.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-share.png)\{: width="100%" \}  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

<!-- <ul> -->

 *  Task 6: Schedule a notebook to run at a different time
    
    ![preview tutorial video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) To preview this task, watch the video beginning at 02:08. Follow these steps to create a job to schedule the notebook to run at a specific time or repeat based on a schedule: 1. Click the **Jobs** icon, and select **Create a job**.  
    ![Create a job](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-create-job.png) 1. Provide the name and description of the job, and click **Next**. 1. Select the notebook version and environment runtime, and click **Next**. 1. (Optional) Click the toggle button to schedule a run. Specify the date, time and if you would like the job to repeat, and click **Next**. 1. (Optional) click the toggle button to receive notifications for this job, and click **Next**. 1. Review the details, and click either **Create** (to create the job, but not run the job immediately) or **Create and run** (to run the job immediately). 1. The job will display in the **Jobs** tab in the project. \#\#\# ![Checkpoint icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/checkmark--filled-blue.svg)\{: iih\} Check your progress The following image shows the Jobs tab.  
      
    ![The following image shows the Jobs tab.](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/gs-notebook-job.png)\{: width="100%" \}  
    [Back to the top](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-analyze.html?context=cdpaas&locale=en#video-preview)  
    
<!-- </ul> -->

## Next steps ##

Now you can use this data set for further analysis\. For example, you or other users can do any of these tasks:

<!-- <ul> -->

 *  [Cleansing and shaping data](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-refine.html)
 *  [Build and train a model with the data asset](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/get-started-build.html)

<!-- </ul> -->

## Additional resources ##

<!-- <ul> -->

 *  View more [videos](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/videos-wx.html)\.
 *  Find sample data sets, projects, models, prompts, and notebooks in the Samples to gain hands\-on experience:
    
    ![Notebook icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/notebook.svg)[Notebooks](https://dataplatform.cloud.ibm.com/gallery?context=wx&format=notebook) that you can add to your project to get started analyzing data and building models.
    
    ![Project icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/ibm-cloud--projects.svg)[Projects](https://dataplatform.cloud.ibm.com/gallery?context=wx&format=project-template) that you can import containing notebooks, data sets, prompts, and other assets.
    
    ![Data set icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/data--set.svg)[Data sets](https://dataplatform.cloud.ibm.com/gallery?context=wx&format=dataset) that you can add to your project to refine, analyze, and build models.
    
    ![Prompt icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/prompt.svg)[Prompts](https://dataplatform.cloud.ibm.com/gallery?context=wx&format=example-prompt) that you can use in the Prompt Lab to prompt a foundation model.
    
    ![Model icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/model.svg)[Foundation models](https://dataplatform.cloud.ibm.com/gallery?context=wx&format=foundation-model) that you can use in the Prompt Lab.

<!-- </ul> -->

**Parent topic:**[Quick start tutorials](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/quickstart-tutorials.html)

<!-- </article "role="article" "> -->