# Quick Start Guide

Follow these steps to start your journey by interfacing with the Rendered.ai web interface to create an account, configure a graph, run a job, and download the resulting dataset. After registration and signing in for the first time, users will be taken to the Landing page. The Landing page is where you can view recent work across organizations and drill down into the the Organization-specific data quickly.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2F58JwC7DyM74Pjt39p3sc%2FLanding%20Page.png?alt=media&#x26;token=daf3438d-5e1d-4425-ad0f-b63496de53f9" alt=""><figcaption><p>Landing Page</p></figcaption></figure>

Clicking on the drop-down icon next to our organization will give us quick access to the Workspaces, Channels, Volumes, GAN Models and Annotation Maps that the organization has access to.

### Setting up your Organization  <a href="#setting-up-your-organization" id="setting-up-your-organization"></a>

New accounts with Rendered.ai will want to customize their Organization. The Organization is where all workspaces will be housed and where all members from your business will be able to share their work, contribute to channels, and generate new datasets. Initially the organization is named after the name of the user it was created for, to edit this name we will go to the Organization Setting page. We can get there one of two ways, the first is by clicking on the Organization name on the left hand side of the screen then clicking on the _Settings_ button.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2Fdvh44ccA5RSH2bwn3uwz%2FLanding%20Page%20Organization%20Settings.drawio.png?alt=media&#x26;token=5882bcbd-f9e5-4ae7-b510-9cf618448296" alt=""><figcaption><p>Landing Page Organization Settings</p></figcaption></figure>

The second method is to click on the User Icon in the top-right, and click on the _Organizations_ from the drop-down list.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FxwFOohXaWl4l4HYDpHeA%2FUser%20Organizations%20from%20Icon.drawio.png?alt=media&#x26;token=4109523f-c5bb-49e2-ad25-8c778ebe5ceb" alt=""><figcaption><p>User Organizations</p></figcaption></figure>

The Organization Settings page has information about the organization: the name, organization ID and plan. It also contains information about limitations put on the organization and any workspace within the organization. We will edit our organization name by clicking on the pencil icon next to our organization name, entering the new name and clicking _Save_.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FamcF4eaTyRtg9qFCyBaX%2FEditing%20the%20Organization%20Name.png?alt=media&#x26;token=0cb5a319-6b43-49e3-a329-15bde79ba830" alt=""><figcaption><p>Editing the Organization Name</p></figcaption></figure>

Now that we’ve customized our organization name, lets take a look at what you can do within the organization.

### Workspaces <a href="#workspaces" id="workspaces"></a>

Every new organization that is created within Rendered.ai is given a workspace. The workspace in your organization will depend on if you entered a Content Code during the registration process or not. A workspace is a place to create graphs and generate datasets which may be shared within or outside your organization. You can create a new workspace by selecting the organization and clicking the green _New Workspace_ button.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FjwUWdnu6CmDIftsEBgE7%2FNew%20Workspace%20Button.drawio.png?alt=media&#x26;token=d83ab604-d52f-4c2c-80c7-9a720ee4da7a" alt=""><figcaption><p>New Workspace Button</p></figcaption></figure>

For this new workspace, we are going to name it Example and add the example channel to it. You could optionally specify a Content Code which could include additional data. To learn more about Content Codes, see our application user guide on [Content Codes](quick-start-guide/content-codes).

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FTrL9Yc0DdNYTIG2T80hz%2FCreating%20a%20Workspace.png?alt=media&#x26;token=6039a3b1-11e8-491c-9c47-4b282e62c246" alt=""><figcaption><p>Creating a Workspace</p></figcaption></figure>

For this workspace we have selected Rendered.ai’s Example channel. [Channels](terminology#channel) define the simulation architecture (3D objects, backgrounds, sensors, sensor platforms, etc.) required to generate synthetic data. The Rendered.ai Example channel serves as a generic channel (toys generated in a box) that allows you to experiment and learn the platform. This channel corresponds to the public codebase on Github: [Rendered-ai/example](https://github.com/Rendered-ai/example). New organizations are provided with the Example channel. Rendered.ai develops a number of other channels for various applications that are available on request. Channel customizations can be made directly to a cloned version of the Example codebase (see [Ana Software Architecture](../development-guides/ana-software-architecture)), or provided as an Engineering service by Rendered.ai .

After creating the workspace, we can go into the workspace to generate synthetic data. Initially the workspace will be empty and look like the screenshot below. We will need to create a graph before we can generate the synthetic data.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FOjW31OHrEEfUdtNQNVzx%2FEmpty%20Workspace.png?alt=media&#x26;token=c882d03b-60cd-405e-bc8f-402b3c63098d" alt=""><figcaption><p>Empty Workspace</p></figcaption></figure>

### Graphs within a Workspace <a href="#graphs-within-a-workspace" id="graphs-within-a-workspace"></a>

A [graph](https://dadoes.atlassian.net/wiki/spaces/ENG/pages/1793949979/Release+0.3.0+-+Terminology#Graph) is a visual diagram that is based on a channel’s codebase, allowing you to view the objects and connections that exist in that channel, modify them within the diagram view, and stage the modified channel to produce simulation sets. Within the workspace view, create a new graph by clicking the New Graph button on the left-hand side of the screen.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FhkRvp9Z36nON3SM49COh%2FNew%20Graph%20Button.drawio.png?alt=media&#x26;token=8c79508d-b2ff-47a1-b660-97c792587f71" alt=""><figcaption><p>New Graph Button</p></figcaption></figure>

Provide a graph name, channel and optionally a description for the graph then click Create. We can also optionally upload a JSON or YAML representation of a graph that will place nodes and links for us rather than a default graph.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FbhcPISWgstswTtC9oAuM%2FCreating%20a%20Graph.png?alt=media&#x26;token=cb252a42-38ba-416c-9bb6-fa82d3c7cce0" alt=""><figcaption><p>Creating a Graph</p></figcaption></figure>

Once created, the graph can be viewed as a node-edge diagram in the graph viewer. You can learn more about [Creating and Using Graphs](tutorials/creating-and-using-graphs) and [Graph Best Practices](tutorials/creating-and-using-graphs/graph-best-practices) by following these links.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FpMkDPAZBBJ5zllNToqM1%2FToys%20in%20Boxes%20Graph.png?alt=media&#x26;token=9c24115f-828b-4189-9b59-bd95083dd817" alt=""><figcaption><p>Toys in Boxes Graph</p></figcaption></figure>

Clicking the _Preview_ button in the top right of the screen renders a sample image of the provided graph configuration, allowing you to ensure your requirements are met before staging the graph for production.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2Fsq5GidiHqdtE38vo0zPy%2FPreview%20Button.drawio.png?alt=media&#x26;token=f29ecf43-9bb8-4dca-a6c7-e867434b39ba" alt=""><figcaption><p>Preview Button</p></figcaption></figure>

The below is an image generated during preview of the default graph on the example channel.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FPsm2WUqYv97eIvLjpDtS%2FPreview%20Default%20Graph.png?alt=media&#x26;token=34d9f907-22fc-44e5-9436-30cccc2b0594" alt=""><figcaption><p>Preview Default Graph</p></figcaption></figure>

Staging Graphs within the Jobs Manager

Once the graph is providing a satisfactory output, it can be [staged](terminology#staged-graph) by clicking the _Stage_ button on the top right of the screen.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FIBOXGOQOWTXLeiNEJygh%2FStage%20Button.drawio.png?alt=media&#x26;token=fc332854-edb9-4aad-8ac5-b4abb4312874" alt=""><figcaption></figcaption></figure>

Staging a graph adds an item to the Staged Graphs section of the job manager.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FBJROWSD5UxMPL8vRCSuM%2FStaged%20Graph%20Section%20of%20Jobs%20Page.png?alt=media&#x26;token=e0ef728a-d560-416f-a4ad-b00b2455c371" alt=""><figcaption><p>Staged Graph Section of Jobs Page</p></figcaption></figure>

When configuring a dataset [job](terminology#job), a name and description can be given to the output [dataset](terminology#dataset), and you can specify the number of images to generate, as well as a specific seed to initialize the random number generators in order to match results across multiple runs if desired. You can also designate priority for the job if multiple jobs are being run at once. To access this information click the down arrow to the right of the staged graph name. Clicking the _Run_ button will launch a new dataset job.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FnrzJlHtQ2QF2UpAYVDWk%2FToys%20in%20Boxes%20Staged%20Graph.drawio.png?alt=media&#x26;token=aab025c1-c876-4ad8-a10d-b8aeb988b7fd" alt=""><figcaption><p>Toys in Boxes Staged Graph</p></figcaption></figure>

Once the dataset job has started, you can view more detailed status of the job by pressing the downward-facing arrow on the right-hand side of the job.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2FEPiScCW6h57oJJd7a2tZ%2FRunning%20Dataset%20Job.png?alt=media&#x26;token=e8f59627-f8a0-41d9-8fce-2b1d8be7aaad" alt=""><figcaption><p>Running Dataset Job</p></figcaption></figure>

This shows average time per image, and gives an estimated end time for the run. It also provides information about compute instances being used to process the job.

### Dataset Library <a href="#dataset-library" id="dataset-library"></a>

Once the job is complete, you can find the dataset in the Datasets Library section of the workspace.

<figure><img src="https://3091318601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPMRyh7BHNPMVqv2031A%2Fuploads%2F2P87shtZjdEksHNK7ML3%2FDatasets%20Library.png?alt=media&#x26;token=6aa2a08a-ecfc-453a-812b-b883b89d9aa1" alt=""><figcaption></figcaption></figure>

From here, you can view more information about the dataset. You can download a compressed version of the dataset and begin using the outputs to train your AI. To learn more about Datasets, reference our guide [Creating and Using Datasets](tutorials/creating-and-using-datasets). You can also use services to learn more about the dataset, compare datasets or generate new annotations.

### Next Steps <a href="#nest-steps" id="nest-steps"></a>

Now that you have set up a new workspace, staged a graph, and created a dataset, we recommend you learn about [Organization and Workspace resources](tutorials/organization-and-workspace-resources).
