---
description: >-
  Here we will describe the few steps that will help you discover all the parts
  of Picsell.ia, this will follow the onboarding that you should see when you
  first connect to the platform.
---

# Start using Picsellia

Here you can add people to your Organization so you can later collaborate with them on common projects and give them a role so you are sure that they only have access to intended information, data...In this tutorial we will see :

1. **What is a `Project`**
2. **What is an `Experiment` :**
   1. **Overview**
   2. **Data**&#x20;
   3. **Files**
3. **What is the `Datalake`**
4. **What is a `Dataset`**
5. **What is an `Organization`**

## Welcome to Picsell.ia

The first thing you see when landing on Picsell.ia is your homepage and it should look like this&#x20;

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me--Rq67RInh6khFQpk%2Fimage.png?alt=media\&token=6e8842cf-75d9-43f9-a217-c9b5810358e3)

To start our tutorial series, let's click on the 'Start' button in the upper card

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MSDCAp9s4fKMrqjO7dX%2F-MSDSPU2stDlEJrupoQ8%2Fimage.png?alt=media\&token=4f652c59-a307-4dd5-b301-b52fbbcd79d4)

## 1. What is a Project ?

In the first step of our tutorial, we are going to see what is a project, if you have followed the introduction, you should now see a page like this&#x20;

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me--bvrtAOy2OZoscZz%2Fimage.png?alt=media\&token=f7cb504c-1423-4688-974d-d7b82dbb6013)

This is what we call a **project overview**.&#x20;

It is the page that summarizes all of the asset that belongs to or can be used in a project.

The two most important things to notice here are the following :

### Dataset section

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me--hzgiBnADDElnyhF%2Fimage.png?alt=media\&token=bdcaa558-15b4-4bfb-9d12-e87caec7ac70)

In Picsell.ia, your data (images + annotations) are completely independent of your projects. But to help you organize your work, we allow you to **attach** some datasets to your projects so you don't have to search within all your data when looking for something in particular inside a project.

The **Datasets** section in your project overview indicates the list of datasets attached to your project, allows you to attach a new dataset, and to set a dataset as **default.** Setting a dataset as default is telling your experiments (we will look into this later) to use it as a default source of data in case nothing is specified.

### Experiment section

As you might have guessed, this is the list of the latest experiment created in this project.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me--oGTwA69yMZhXZ5p%2Fimage.png?alt=media\&token=9623dc55-1b87-4a8d-8efb-5a8b1848a3ff)

From here, you can click on 'see all' to access the whole list, click on one row to dive into one experiment, or create a new experiment by clicking the green button in the upper-right corner.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MSDCAp9s4fKMrqjO7dX%2F-MSDVqLm45ChFVMnbbFi%2Fimage.png?alt=media\&token=99b97a30-c92f-495e-bd9b-b64d0987e476)

The **Dataset** column tells you that a dataset is attached to an experiment and if you click on its name (in green here) you will be able to access the dataset directly.

Now let's **click on the first row** (my first experiment) to see what experiments are made of.

## 2. What is an Experiment ?

Experiments are entities grouped under a project. An experiment is the place where you can store files, log your results in interactive charts, dive into your train/test/eval sets of data (when linked to a dataset), store and display server logs, and even run trained model.

If you have followed the previous step, you should now be on a page that we call the Experiment Overview, that displays everything that you have logged.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me--zxO2j5uytMDZVT6%2Fimage.png?alt=media\&token=13a10789-99b3-4ad0-a05f-bd62d326dc51)

### Summary

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-06eJidbnhy6Hm_6_%2Fimage.png?alt=media\&token=2b8cb313-6a64-4164-a2ec-bb2e94dc659d)

This header summarize the core informations of your experiment such as the owner (the user that created the experiment), the dataset (if any), but also the most important metrics that you need to see in one glimpse (e.g. final accuracy, loss...) and any `values` you have logged (see [this section](../../experiment-tracking/log-your-results-to-picsell.ia#single-value) for more information about logging to an experiment)

### Logs

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-0CcyC1so_ZOCAZhQ%2Fimage.png?alt=media\&token=04064e27-85fa-4d79-bff6-5149bceb086a)

As you can see here, you have multiple options available if you want to save data and share it with your team on Picsell.ia.

Please check the [full documentation on logging](../experiment-tracking/log-your-results-to-picsell.ia) to see what are all the available types of charts you can display and how to use them.

In order to interact and notify your team instantly in the platform, you can add comments and tag members under any chart in an experiment by clicking on the 'Add a comment' button.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MSDCAp9s4fKMrqjO7dX%2F-MSDlLA-hyW9HNRtvlst%2FCapture%20d%E2%80%99%C3%A9cran%20de%202021-01-29%2016-29-55.png?alt=media\&token=c3bc8479-9a13-4398-85d1-2fb802f11125)

Now please click on the **Artifacts** tab in the header.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MSDCAp9s4fKMrqjO7dX%2F-MSDqkgbKXurDFJjzFi9%2Fimage.png?alt=media\&token=59732128-06b8-4661-bce2-0aee09c2f7a6)

### Artifacts

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-A5BDbisw6pB7qdne%2Fimage.png?alt=media\&token=2fea2166-1ca9-4c2c-afc1-96d8cb546aad)

You can consider this as your experiment **storage**.

When you [store files](../experiment-tracking/store-your-files-to-picsell.ia) using our [Python SDK](../references-1/python-sdk-reference-1), they are listed here.

For each file you have access to several information :

* Its name (unique, used to retrieve the asset)
* Its filename (for example main.py)
* The update date
* The upload data
* The size (small if < 5Mo, large if not)

To download a file you can click on the icon on the upper-right corner of the desired card&#x20;

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MSDCAp9s4fKMrqjO7dX%2F-MSDsE-Qlr8miEFT2749%2Fimage.png?alt=media\&token=da3e71b8-ceda-4975-9473-ca37feee08ef)

{% hint style="info" %}
As for the data, we have a namespace for files that allows us to automatically recognize some of them to perform actions (such as deploying a model, launch a training...). Please refer to [this page](../../experiment-tracking/namespace#file-namespace) to see the reserved namespace.
{% endhint %}

### Other tabs

You may have notices that we didn't covered all the tabs of the header, such as Telemetry or Test, in this tutorial. But don't worry, we wanted to keep it simple for now but we will see what's in it later.

## 3. What is the Datalake ?

No, you are not dreaming, at Picsell.ia we make available to you your **own private Datalake** 😎

We know you can't wait to discover it so here is what it looks like :

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-B7_oGyK09vvyMDul%2Fimage.png?alt=media\&token=902eac19-020b-4277-85fe-9199fa234095)

The Datalake is the place where you can upload, import, tag and sort all of your data.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-BNXBKUirClOquOtV%2Fimage.png?alt=media\&token=c2c15b7d-805c-428e-b45d-f1ad1ac4225a)

This table lists literally **ALL** your assets. But to help you dive into your data and find what you need, we have added a powerful search input where you can search for tags and filenames.

If you select some assets by ticking some checkboxes in the table you will see something like this.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9gogHN8fVxjxrV4CX%2F-Mc9iwFPtFMjS6heocC0%2Fimage.png?alt=media\&token=fff8758e-bebe-4d7f-95b5-34f88e3dc794)

This is the list of operation that you can perform on your data, here you can :

* add assets (upload or import images)
* add tags (to the selected images)
* create new datasets (so you can select and version data easier)
* import data (in an existing dataset)
* create a new version (of a dataset, with new assets)

To see the details of how each operation works please refer to the [corresponding page](../../data-management#1-the-datalake) of the documentation.

Now that we have seen how data is stored globally on Picsell.ia thanks to the Datalake, let's now dive deep into datasets, what you can with them and why it's awesome.

## 4. What is a Dataset ?

If you are familiar with AI and Data Science, you have inevitably heard of a 'dataset' some day in your life.\
But as you may not know how Picsell.ia works, we will still explain what a **Dataset** is here.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-BdmTJxC4DFQGy7j0%2Fimage.png?alt=media\&token=ccc06bd0-aeb5-4ec4-9b8a-fdb3f5edcf63)

This is a **Dataset version** page. At first, it looks quite similar to the Datalake page, let's see what we really have here.

### Annotations

The first use of a dataset is the ability to **annotate** your data.&#x20;

In this screenshot, you can see the same kind of table as in the Datalake, except that there are new columns.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-BnHqSpOZ87C61VOL%2Fimage.png?alt=media\&token=31cab7b8-2013-4ef3-8569-4d2119c620db)

Indeed, by clicking on the green button at the end of each row, you can access our **labeling interface** that allows you to create ground truth for your future experiments (we will see the interface later).\
As we can see, some images are annotated (the **Instances** column indicates the classes labeled in the image).

### Analytics

You can access your Dataset analytics page by clicking on the `analytics` tab&#x20;

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9j68vSPyI3yz_4qVz%2F-Mc9mTBEGnTNxHFMnhb4%2Fimage.png?alt=media\&token=7e113622-a1f9-4d90-b39c-9b22fe877fe2)

On this page you'll be able to visualize your :

* Dataset repartition ( number of objects by class )&#x20;
* Object by Image distribution&#x20;
* Object width distribution
* Object height distribution
* Annotation performances&#x20;

### Settings

You can access your Dataset settings by clicking on the `settings` tab

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9j68vSPyI3yz_4qVz%2F-Mc9n_RbRljf2PYkRDCs%2Fimage.png?alt=media\&token=d60311c7-ccd9-42c6-94b9-c95bd65ffefd)

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9j68vSPyI3yz_4qVz%2F-Mc9njBEXikZXBeRQGGV%2Fimage.png?alt=media\&token=4b23adc9-6991-4572-b4a4-823a8f6a46d7)

Thanks to your settings page you'll be able to:

* Configure/modify your labels
* Import annotations from other dataset version
* Configure/modify questions and answers asked during the annotation process

## 5. What is an Organization

Yes, you guessed it, this is the last part of this tutorial about Picsell.ia (but please don't cry we have a lot more to show you in the other section of the docs ! 😇)

When you create an account on Picsell.ia (we are glad you did) we automatically create your own Organization.&#x20;

If you take a look at the main sidebar of the platform, at the top you should see a collapsible link with the name of your organization (which is at first the same as your username).

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-MdzxY2m2CUMU1VmA1ne%2F-Me-C10KAlg44Kpi9C7u%2Fimage.png?alt=media\&token=6ac7b85f-a3ac-4e9b-8cf2-2b50dfcb3e8c)

Here we have access to several links that will redirect you either to your profile settings or to your Organization settings

Let's click on the **Informations** link to see what Organization are here for.

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9j68vSPyI3yz_4qVz%2F-Mc9oaJrhvzJw0qUJ-23%2Fimage.png?alt=media\&token=89081d92-1333-4844-9434-7909743415ac)

These tabs are your Organization's settings. From here you can

* Add members to your organization
* Have access to your billing details and invoices
* Update your subscription

### Members

For now, we will just learn how to add members to our Organization

![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9j68vSPyI3yz_4qVz%2F-Mc9oiYEtziQmdnA2DX0%2Fimage.png?alt=media\&token=805aeda7-8853-4c3c-8d22-64f7b8a8ee4b)



![](https://2100239547-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M78aoA9Gcxf25O1fNjm%2F-Mc9j68vSPyI3yz_4qVz%2F-Mc9ooWAL2slzUMf-Kqu%2Fimage.png?alt=media\&token=56756883-349c-4e29-8472-e12da37c7eca)

If the person you are looking for already has an account on Picsell.ia, you can enter his/her email or username and it will send them an invite to join your Organization.

If not, you have to enter a valid email address and we will send them an email containing an invitation to join Picsell.ia and your Organization.
