Skip to content

IRTK Learning Path README.md Max 2-tile env var #2265

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 26, 2024
Merged

IRTK Learning Path README.md Max 2-tile env var #2265

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
71ecf30
IRTK Learning Path Max env vars w/a
MichaelRCarroll-Intel Mar 26, 2024
f9607dd
Update README.md
jimmytwei Mar 26, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 18 additions & 10 deletions RenderingToolkit/IRTK_Learning_Path/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
## Title
Intel® Rendering Toolkit Learning Path
# Intel® Rendering Toolkit Learning Path

## Requirements
| Optimized for | Description
|:--- |:---
| OS | Linux* Ubuntu 22.04
| Software | Intel® Rendering Toolkit (Render Kit), Jupyter Notebooks, Intel® Developer Cloud (IDC)

# Intel® Rendering Toolkit Jupyter Notebook Learning Path
## Description
This repo contains Jupyter Notebook Trainings for Render Kit that **has been designed to be used on the Intel Developer Cloud** for hands-on workshops.

At the end of this course, you will be able to:
Expand All @@ -24,10 +24,10 @@ Third party program Licenses can be found here: [third-party-programs.txt](https

## Content Details

#### Pre-requisites
### Pre-requisites
- C++ Programming

#### Training Modules
### Training Modules

| Modules | Description
|---|---|
Expand All @@ -44,16 +44,24 @@ Third party program Licenses can be found here: [third-party-programs.txt](https
|[Intel® OSPRay Studio tutorial](6_OSPRay_Studio/OSPRay_Studio.ipynb)| + Basic demonstration on how to use Intel® OSPRay Studio with its interactive interface.


#### Content Structure
### Content Structure

Each module folder has a Jupyter Notebook file (`*.ipynb`), this can be opened in Jupyter Lab to view the training contant, edit code and compile/run. Along with the Notebook file, there is a `lab` and a `src` folder with SYCL source code for samples used in the Notebook. The module folder also has `build_*.sh` and `run_*.sh` files which can be used in shell terminal to compile and run each sample code.

#### Access using Intel Developer Cloud
### Access using Intel Developer Cloud

The Jupyter notebooks are tested and can be run on Intel Developer Cloud without any installation necessary, below are the steps to access these Jupyter notebooks on Intel Developer Cloud:
1. Register on [Intel Developer Cloud (IDC).](https://console.cloud.intel.com/)
2. Create and account and/or log in.
2. Create an account and/or log in.
3. Once in IDC dashboard, go to Training in the left panel and then click the Launch JupyterLab botton in the upper right.
3. Open Terminal in Jupyter Lab and git clone the repo and access the Notebooks.
4. Open Terminal in Jupyter Lab and git clone the repo and access the Notebooks.

Note that the oneAPI Base Toolkit and the Intel Rendering Toolkit are already pre-installed in IDC.
Note that the oneAPI Base Toolkit and the Intel Rendering Toolkit are already pre-installed in IDC.

### Workaround for 2-Tile Intel® Data Center GPU Max Series (PVC)

Intel OSPRay, Intel Embree, and Intel OpenVKL based programs need to use the environment variable ZE_FLAT_DEVICE_HIERARCHY and set it to COMPOSITE.

Use the following command in your shell or Jupyter Notebook cell before running programs:

`export ZE_FLAT_DEVICE_HIERARCHY=COMPOSITE`