# What's Celly?

**Celly** is an iOS app for **lab microscopy automation**. It makes slide scans, counts cells, and detects abnormalities **by the means of AI**. You just mount the iPhone to the eyepiece of a microscope and the App makes the rest.

{% embed url="<https://youtu.be/SrEqkjHpq04>" %}

## With Celly you can

* Make **whole slide scans** and store them in the cloud. Share your slides and invite remote colleagues for **telemedicine**, **education**, and **presentations**&#x20;

![The microscope become a slide scanner. No need for any expensive hardware](/files/-MJSz9X9d0Sed3iJ0t5Q)

* **Automate** microscopic tests such as **WBC differential**, **malaria detection,** and many others

<figure><img src="/files/Qfvc87KZh71PifdfpdZj" alt=""><figcaption><p>Review results on the website</p></figcaption></figure>

* **Manage** your data, integrate with **LIS**, and collaborate with **team members**&#x20;

![Live remote sharing for pathology consultations, and classroom demonstrations ](/files/-MJT1aaHu3NNRO3tN1PH)

## What's next?

The best way to explore Celly is to try it out — so don't wait and [download the App](https://apps.apple.com/us/app/celly-ai/id1506941881) (it's completely free!). Here are some things to start with:

{% content-ref url="/pages/-MJNQew3n7TgU\_FyIoDe" %}
[First Steps](/getting-started/first-steps)
{% endcontent-ref %}

Still, have some questions? Check our FAQ:

{% content-ref url="/pages/-MJT2dkvpuCkKdrPN9ML" %}
[FAQ](/getting-started/faq)
{% endcontent-ref %}


# First Steps

Onboarding takes no more than five minutes, so let's go! 💥

## 🏁 Create an account

Celly is free for non-commercial usage and requires no card info. Go to the [**signup page**](https://celly.ai/), choose a username and password to create your personal account. You can sign up through the [**mobile app**](https://apps.apple.com/us/app/celly-ai/id1506941881) too.

## 📲 Download the app

Download the [**Celly app**](https://apps.apple.com/us/app/celly-ai/id1506941881) from the AppStore - it's absolutely free! Sign in with Celly website credentials.

{% hint style="info" %}
The app requires iOS version 13+ and iPhone model 8 or higher.
{% endhint %}

## ✅ Get an adapter

Before you start, you should get [**an optical adapter**](https://www.ilabcam.com/products/labcam-ultra-for-iphone) to connect your phone to the microscope.

![The adapter is compatible with 99% types of lab microscopes](/files/-MJTDbOd7elcqqAnrxiN)

{% hint style="info" %}
Celly supports the LabCam Ultra adapter. Compatibility with other adapters is not guaranteed
{% endhint %}

Attach your iPhone to the eyepiece of a microscope. Put the sample, turn on the light, set the lens focus.

![](/files/-MJW8m-RBGTPnM7k8T4c)

## 🔬 Next steps

Now you know the basics, but there is so much more to explore! AI-automation, LIS integration, team management, and even more.

A nice idea would be to learn how to automate CBC test

{% content-ref url="/pages/-MJT2ll-25iXcNTyt5nv" %}
[Blood: CBC test](/supported-tests/blood-wbc-differential)
{% endcontent-ref %}

Enjoy Celly and leave your feedback at [support@celly.ai](mailto:support@celly.a)


# FAQ

## Who has rights to the data?

Your data is yours.

We respect your privacy and when you create an account you don't grant us any rights to your data, except for the ones that need for the application functioning. We don't use your data for any commercial or non-commercial purposes and share it with nobody. You can learn more in the [terms of service](https://celly.ai/terms).

## How can I change the white balance?

App Settings -> Manual white balance = Yes -> Tap **Gray Card** button or change with sliders.

## I have shadows around the borders

It's OK if you have black corners (the application automatically crops 15% from each border). But if the adapter not ideally fits with the eyepiece, you can get additional shadows around the borders. This affects the scan quality and cell counts. To avoid the problem:

* try to move the adapter
* increase the crop level: App Settings -> Cropping &#x20;


# Support

Something is not clear and you want some help? Please use the resources below:

* Live Chat — That blue button in the right bottom corner with live support
* <support@celly.ai>— Old and plain e-mail is still there!


# Blood: CBC test

A **complete blood count** (**CBC**) is a laboratory test that indicates the counts of white blood cells, red blood cells, and platelets.

A **white blood cell differential** is a laboratory test that provides information about the types and amounts of white blood cells in the sample. The test measures the amounts of the five normal white blood cell types – **neutrophils, lymphocytes, monocytes, eosinophils**, and **basophils** – as well as **abnormal cells** if they are present.

![White blood cells](/files/-MJYTNfzH9_EltebLDcd)

Microscopist examines the smear in a systematic pattern, scanning from side to side within the **feathered edge** (single layer of cells at the end of the smear) and counting cells consecutively. Microscopist counts at least **100 white blood cells** using **100x or 40x objective lens magnification**.

![Scanning pattern](/files/-MJYRt6WbtZABr58Bbse)

Celly supports 2 types of CBC test - manual CBC and CBC with motorized stage.

After the test finish you can review results on Celly website.&#x20;

## Results review

* Log in on the [**website**](https://app.celly.ai). Go to the [**Tests**](https://app.celly.ai/app/analysis/) page. Push the **View** button to open your report.
* Go to the **Cells** tab. Drag the cells to the appropriate type to correct errors. Confirm the test using the **Approve** button.

{% hint style="success" %}
Use the **hotkeys** for the fast class correction: hover over the cell and press the hotkey button - the cell will immediately change the class
{% endhint %}

![Cells Page](/files/AUIl0hxpA9yZYATeN86a)

* &#x20;On the **Snapshots** page, you can review the photos. The application automatically captures 10 photos during the test. You can find here your manual snapshots too.

![Snapshots page](/files/-MbCx_fAyKBlGhNGlEnV)

* On the **Report** page, you can review and download the final PDF report with the following sections:
  * **WBC-differential**, reference ranges, and abnormality flags.&#x20;
  * **RBC distribution** by Size, Shape, Color, and Inclusions

![Report: WBC-diff](/files/-MbfSVWmdsVw_B0Kjwpe)

![Report: RBC distribution](/files/-MbfSK4qQBLl-YINGCdB)

{% hint style="info" %}
Celly can automatically store results in LIS, [see instruction](/config/lis-integration)
{% endhint %}

{% embed url="<https://youtu.be/B2AyEIteSQk>" %}
Full blood count video tutorial
{% endembed %}

{% embed url="<https://youtu.be/nbRUiWl2Qrs>" %}
Staining smears tutorial
{% endembed %}


# CBC manual

Preparation&#x20;

Put the sample, turn on the light, use 100x immersion objective magnification, and set the lens focus. Move the field of view to the  monolayer of cells.

#### Test execution

Open the test **configuration panel** (left bottom corner). Set **Test type = Blood: CBC.** Tap the main screen to return.

<figure><img src="/files/UOZ4RyrVt4r3ZDirIFhq" alt=""><figcaption></figcaption></figure>

Let's check the **app settings** - push the **gear icon** in the right bottom corner to open the menu. Set Sensitivity in range 60-80%. Leave the other settings as they are.&#x20;

<figure><img src="/files/NhqgBH8xLurTjotZmkMM" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
At the first launch, the app will ask you to calibrate color. Move the field of view over an empty area and press Ok
{% endhint %}

Start your test using the **Red Record Button** :red\_circle: Move your slide, controlling the focus. The app will automatically detect and count white blood cells. Finish your test (Stop button -> Complete) or the app will complete the test automatically (when reach configured number of Cells).

![Celly automatically detects and counts white blood cells](/files/-MMVYqiJ19MouConmPey)

{% hint style="info" %}
If a cell was not detected, hold it with your finger for a few seconds
{% endhint %}

The test will automatically finished when you achieve configured number of cells.&#x20;


# CBC automated

{% hint style="success" %}
Prerequisites:

* iPhone connected to the eyepiece
* Celly motorized stage connected
  {% endhint %}

Set blood smears in the tray (thin part away from you), apply oil to the center of the slides.

{% hint style="info" %}
Before the app launch move up the stage to 100x lens level
{% endhint %}

Open the Celly App -> configure analysis -> Type = Blood (CBC).&#x20;

Set the settings (gear icon) as in [configuration file (cbc motorized)](https://docs.google.com/spreadsheets/d/1nGfDZY1ebK6rVIexb5B_TJ4W71JvwBAVQ7kCXRCxcXo/edit?usp=sharing)

Restat the app to configuration apply.&#x20;

Start your test 🔴 and enjoy automation!


# Bone marrow: WBC differential

**Bone marrow (BM) aspiration examination** refers to the pathologic analysis of bone marrow samples. Bone marrow examination is used in the diagnosis of a number of conditions, including leukemia, multiple myeloma, lymphoma, anemia, and pancytopenia.&#x20;

![Bone marrow smear](/files/-MJZ1irLwRnxjtrAtDWw)

The test performing is similar to [**Blood: WBC differential**](/supported-tests/blood-wbc-differential), however, there are the following differences:

* App Settings: **Cells To Analyse for BM = 500** (Blood = 100)
* Result review -> Cells: For the BM test **the list of cell types is wider**, includes: Blast, Prolymphocyte, Lymphocyte, Plasma Cell, Promonocyte, Monocyte, Promyelocyte, Myelocyte, Metamyelocyte, Eosinophil, Basophil, Band Neutrophil, Segmented Neutrophil, Proerythroblast, Basophilic Erythroblast, Polychromatic Erythroblast, Orthochromatic Erythroblast, Megakaryocyte.
* Result review -> Report: For the BM test the system automatically calculates main indexes - **M:E, I:Mg**, and **I:Me ratio**.

![Report example](/files/-MJZ6NwY1M22Vg9_oz6Q)

{% hint style="info" %}
M:**E** - Number of myeloid cells/Number of nucleated erythroid cells

**I:Mg** - (Number of myeloblasts + promyelocytes + myelocytes + metamyelocytes)/(Number bands + segmented)

**I:Me** - Number of proerythroblasts + basophilic erythroblasts/Number of polychromatic and orthochromatic erythroblasts
{% endhint %}


# Malaria thick blood film

Microscopy analysis of Giemsa-stained thick and thin blood films from peripheral blood is intended to detect, identify, and quantify malaria parasites.

**Thick films** allow the microscopist to screen a larger volume of blood and are about eleven times more sensitive than the thin film, so picking up low levels of infection is easier on the thick film, but the appearance of the parasite is much more distorted and therefore distinguishing between the different species can be much more difficult.

![ Template for preparation of slides with thick and thin blood films](/files/-MJhUL7qj8n5yA36iNFz)

![ Examining a thick blood film](/files/-MJh_S8GsYDAXzqWERu8)

![Parasites in the thick film](/files/-MJheWXFuJF5MPI1RKHF)

{% hint style="warning" %}
The procedure requires 100× oil-immersion objective lens
{% endhint %}

## Malaria thick, using Celly

#### Preparation&#x20;

Put the sample, turn on the light, use 100x objective lens magnification, and set the lens focus. Move the field of view to the single layer of cells.

#### Test execution

Tap the test configuration button: set "**Malaria Thick: parasites counting**" test type, choose a patient.&#x20;

Tap the app settings button. Set the WBC number to analyze (200 by default). Start the test.

Move your slide, controlling the focus. The App will count parasites and white blood cells. After reaching the specified number of cells, the application will complete the test.

#### Result review and confirmation

* Log in on the [**website**](https://app.celly.ai). Go to the [**Tests**](https://app.celly.ai/app/analysis/) page. Push the **View** button to open your report.
* Go to the **Cells** tab to check the pre-classification. Drag the cells to the appropriate type to correct errors.&#x20;
* The app automatically calculates
  * Fields of view analyzed
  * WBC number
  * Parasites number
  * Parasitemia (Parasites in 1μl) = Parasites \* 8000/WBC &#x20;

{% hint style="info" %}
Parasitemia is calculated for 8,000 WBC/μl level
{% endhint %}

![Thick film analysis interface](/files/-MR6VvcSlqhhH_vkMGxY)

**Links:**

* [Microscopy examination of thick and thin blood films for identification of malaria parasites, WHO, 2016](https://www.who.int/publications/i/item/HTM-GMP-MM-SOP-08)
* [Microscopy for the detection, identification and quantification of malaria parasites on stained thick and thin blood films in research settings. WHO on behalf of the Special Programme for Research and Training in Tropical Diseases, 2015](https://apps.who.int/iris/bitstream/handle/10665/163782/9789241549219_eng.pdf?sequence=1\&isAllowed=y)


# Malaria thin blood film

Microscopy analysis of Giemsa-stained thick and thin blood films from peripheral blood is intended to detect, identify, and quantify malaria parasites.

**Thin films** are similar to usual blood films and allow species identification because the parasite's appearance is best preserved in this preparation.

![ Diagram of slide reading](/files/-MJhWRMOvL_EVu0zCxfU)

![Malaria parasites in the thin film](/files/-MJhXep_tJU_6zth1Bk6)

{% hint style="warning" %}
The procedure requires 100× oil-immersion objective lens
{% endhint %}

## Malaria thin, using Celly

#### Preparation&#x20;

Put the sample, turn on the light, use 100x objective lens magnification, and set the lens focus. Move the field of view to the single layer of cells.

#### Test execution

Tap the test configuration button: set "**Malaria Thin: parasites counting**" test type, choose a patient.&#x20;

Tap the app settings button. Set the cell number to analyze (10000 by default). Start the test.

Move your slide, controlling the focus. The App will count red blood cells and probably infected cells. After reaching the specified number of cells, the application will complete the test.

{% hint style="info" %}
Check at least 5000 red blood cells to calculate the parasitemia level
{% endhint %}

#### Result review and confirmation

* Log in on the [**website**](https://app.celly.ai). Go to the [**Tests**](https://app.celly.ai/app/analysis/) page. Push the **View** button to open your report.
* Go to the **Cells** tab to check the pre-classification. Drag the cells to the appropriate type to correct errors.&#x20;
* The app automatically calculates **Parasitemia level** (Infected cells per 1000 RBC) on the slide

How to prepare the slides - <https://youtu.be/vo-JmxTEtk4>&#x20;

Video Tutorial - [Malaria Parasitemia Counting (Thin Film)](https://youtu.be/abS-qmueUoE)


# Slide scan

Slide scan creates a digital copy of the slide and provides it on the Celly website.

The test works just in configuration with [motorized stage](/config/stage) connected.&#x20;

### **Initial settings**

Open the Celly App -> settings (gear icon):

* Crop: 0.10-0.15 (green rectangle shouldn't fall on the black borders) &#x20;
* Mini-map: Off&#x20;
* Motorized Stage: On (can require app restart)
* Motorized Slide Scan: On&#x20;
* Skip prescan step: On
* Virtual pad: On
* Adapter: Other&#x20;
* Recording: Off

Open the Celly App -> configure analysis -> Type = Slide Scan.

Now we should make important calibrations. &#x20;

### Set scan area

Settings -> Set scan area -> Move with virtual pad, to take the scan area.

### Color calibration

Move with Virtual Pad to the empty area.

Settings -> Choose Objective magnification x4 (+ set physically x4 objective) -> calibrate color.&#x20;

Repeat the procedure for all magnifications. After the calibrations restart the app.&#x20;

### Height calibration

Move with Virtual Pad to area with tissue. Set x10 objective.

Settings -> Calibrate height -> wait for the device automatically find the best focus.&#x20;

Now you can make slide scans.&#x20;

### Scanning

Open the Celly App -> configure analysis -> Type = Slide Scan.

Push "Start" button and follow instructions.&#x20;

After the step go to the [**website**](https://app.celly.ai). Open the [**Tests**](https://app.celly.ai/app/analysis/) page. Push the **View** button to open your scan.

{% hint style="info" %}
Hold \<SHIFT> to add annotation on the scan
{% endhint %}

{% content-ref url="/pages/-MJNQew3n7TgU\_FyIoDe" %}
[First Steps](/getting-started/first-steps)
{% endcontent-ref %}

## What's next?

The best way to explore the Celly interface is to check the Education module, which includes:

* [Cell Atlas](/education/cell-atlas)
* [Examination page](/education/examination)


# Cell Atlas

Keep interesting cells in the cloud Atlas

{% hint style="success" %}
To explore the Education functionality you don't need an adapter, just [sign up](https://celly.ai) on the website
{% endhint %}

**Open the cell Atlas**

1. Open the [Atlas page](https://app.celly.ai/app/atlas/)
2. Choose your test type
3. Find stored cells in the Atlas&#x20;

![Cell Atlas is initially populated with standard cells ](/files/-Mh8CSnPldrRin6jQtip)

**Save cells from your test in the Atlas**

1. Open a test
2. Click on the cell -> Add to Atlas

![On the cell preview you can add cell to Atlas or Exam Template](https://lh5.googleusercontent.com/AhPOpGNByUh5efFj-dbREo7zPMsbFvyIf8xI96CTaMQjZjUNJAN-1ntWsoGv_p4-i30VqtlEyPeglwJT099h9zxN1o-0EmdZJmwl06E6EBE-PwKMK7bK1GEmjNCoEG2apNjb7Pld)

{% hint style="info" %}
You can add a description for a cell on the preview page
{% endhint %}


# Examination

Test your students' knowledge online

{% hint style="success" %}
To explore the Education functionality you don't need an adapter, just [sign up](https://celly.ai) on the website
{% endhint %}

**Roles**

* Admin (add cells to the Exam Templates, creates and assigns Exams on the students)&#x20;
* Student (passes exams)

![Exam: Drag the cells from the Unclassified to the proper classes](/files/-Mh8Lg6R1pkAbcNS5uK1)

**Add cells to Exam Template (admin)**

1. Open a Test
2. Click on the cell -> Add to Exam Template

**Create and assign Exam (admin)**

1. Open [Exams Page](https://app.celly.ai/app/exam/)
2. Add Exam&#x20;
   * Set the **test type** (CBC, Malaria, etc)
   * **Choose the student** to assign the exam
   * Set the **cells number** to generate for the exam (the system will randomly take a given number of cells from the template)

**Pass Exam (student)**

1. Open [Exams Page](https://app.celly.ai/app/exam/)
2. Click **View** to open the assigned Exam
3. Drag the cells from the **Unclassified** to the proper classes
4. Click **Finish Test**
5. See your results on the **Report tab**

![Exam report](/files/-MlU0T4hJgZmaS_K71PQ)

{% hint style="info" %}
Admin and Students can review the exam results on the [Exams Page](https://app.celly.ai/app/exam/)
{% endhint %}


# App configuration

Celly app has 2 types of configs:

* **App settings** - camera,  performance, user interface&#x20;
* **Test configuration** - test type, slide id, test history

## App Settings

**Gear icon** in the right bottom corner.

![Settings page](/files/-MJhrwJ_jU3TKxTjvfGN)

### Common settings

**Online preview:** enables mini-map on the top right corner during the test;

**Show metrics**: enables window with performance parameters (CPU, RAM load, FPS);

**Save photo on the device:** on - when you tap the **snapshot icon** (right top corner) the app saves photos on the phone Album; off - save photos on the app web portal (Test->View->Snapshots);

### Camera settings

**Adapter**: enables anti-distortion algorithms. Chose your type of adapter;

**Recording**: record and save the video on the device;

**Calibration**: color balance and exposure calibration (set your microscope brightness on maximum before the calibration to get the best quality images)

## Test configuration

The **blank** **icon** is on the left bottom corner.

![Test configuration panel](/files/-MJXuEcgsvRl0EnzULAO)

**Select a custom test:** set test type, and slide id for the new test;

**Select a pre-set:** you can use pre-configured tests;

**Test history (clock icon):** opens the window with the test history - reports, statistics.


# Team management

There are 4 roles of users:

* **admin** (lab owner) - lab management
* **technician** (work with the microscope) - test performing
* **expert** (experienced specialist) - review the tests on the website;
* **student** (passes exams) - used for [Education](/education/examination)

After the standard sign-up procedure, all new users created as admins. Admin can create **technicians** and **experts** in the **Team › Users ›** [**Add User Page**](https://app.celly.ai/authentication/user/add/)

![](/files/-MVM2HTF90gunJduzCgR)

### Privileges

* **Technicians** can: create/execute and review their own tests.
* **Experts** have all technician rights plus can review all the organization tests;
* **Admins** have all expert rights plus access to:
  * **Users** - create new users
  * **Billing** - change subscription plan
  * **LIS** - integration with a laboratory information management system&#x20;

{% hint style="warning" %}
Admins see all tests of the organization like experts
{% endhint %}

### Example

**User A** - admin;

**User B** - makes tests

**User С** - review the results:

* **User A** signs up on the celly.ai (<userA@email.com>). The user is the admin.
* **User A** creates **User B** and **User C:**  **Team › Users ›** [**Add User Page**](https://app.celly.ai/authentication/user/add/):&#x20;
  * <userB@email.com> (technician) &#x20;
  * <userC@email.com> (expert)
* **User B**  makes tests. **User C** reviews the results.


# LIS integration

Celly lets labs manage the data and store all the reports in their own LIS

{% hint style="info" %}
LIS configuration is available on the Standard and Enterprise plans&#x20;
{% endhint %}

Go to the [**LIS page**](https://app.celly.ai/lis/). If LIS Integration is activated, your LIS can make requests to the Celly server and get analysis results.

{% hint style="success" %}
Use [basic authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) for all requests with **Organization ID** as login and **Secret key** as password. **Organization ID** and **Secret key** can be found at <https://app.celly.ai/lis/>
{% endhint %}

<figure><img src="/files/1xiAoxTVKHZyUp329SLG" alt=""><figcaption><p>Find your organization ID and Secret Key on the <a href="https://app.celly.ai/lis/">LIS page</a> </p></figcaption></figure>

Celly provides APIs that return analysis results to LIS:

1. <https://app.celly.ai/api/lis/v1/analysis/kinds> - returns a list of id and corresponding analysis types

   * `curl -X GET "https://app.celly.ai/api/lis/v1/analysis/kinds" -H "accept: application/json" -H "authorization: Basic $credentials$"`

   ```
   [
     {
       "id": 0,
       "name": "Blood: CBC"
     },
     {
       "id": 1,
       "name": "Bone marrow: WBC-differential"
     },
     {
       "id": 2,
       "name": "Malaria thin: parasites detection"
     },
     {
       "id": 3,
       "name": "Malaria thin: parasites counting"
     },
     {
       "id": 4,
       "name": "Slide Scan"
     },
     {
       "id": 5,
       "name": "Malaria thick: parasites counting"
     },
     {
       "id": 6,
       "name": "Blood: PLT counting (Fonio)"
     },
     {
       "id": 7,
       "name": "Canine Blood: CBC"
     },
     {
       "id": 8,
       "name": "Feline Blood: CBC"
     },
     {
       "id": 9,
       "name": "Canine Blood: CBC, 40x"
     },
     {
       "id": 10,
       "name": "Blood: CBC, 40x"
     },
     {
       "id": 11,
       "name": "Feline Blood: CBC, 40x"
     },
     {
       "id": 14,
       "name": "Pap (liquid-based), 40x"
     },
     {
       "id": 12,
       "name": "Canine Reticulocytes, 100x"
     },
     {
       "id": 13,
       "name": "Feline Reticulocytes, 100x"
     }
   ]
   ```
2. <https://app.celly.ai/api/lis/v1/analysis/statuses> - returns a list of id and corresponding analysis statuses

   * `curl -X GET "https://app.celly.ai/api/lis/v1/analysis/statuses" -H "accept: application/json" -H "authorization: Basic $credentials$"`

   ```
   [
     {
       "id": 6,
       "name": "Pending"
     },
     {
       "id": 0,
       "name": "Active"
     },
     {
       "id": 1,
       "name": "Post Processing"
     },
     {
       "id": 2,
       "name": "In Review"
     },
     {
       "id": 3,
       "name": "Approved"
     },
     {
       "id": 4,
       "name": "Rejected"
     },
     {
       "id": 5,
       "name": "Error"
     }
   ]
   ```
3. <https://app.celly.ai/api/lis/v1/analysis> - provides a list of all tests (in **In Review** / **Approved** / **Rejected** status) of your organization

   * `curl -X GET "https://app.celly.ai/api/lis/v1/analysis?page=1&page_size=3" -H "accept: application/json" -H "authorization: Basic $credentials$"`
   * To list the tests that have not yet been submitted to LIS use `sent_to_lis=False`
   * To filter by status and kind use `kind=id` and `status=id` respectively
   * Use `page_size` to customize the page size, default is 20
   * Use `page` to navigate between pages
   * `count` - total number of filtered tests, `previous`/`next` - link to get previous/next page

   ```
   {
     "count": 107,
     "next": "http://app.celly.ai/api/lis/v1/analysis?page=2&page_size=3",
     "previous": null,
     "results": [
       {
         "test_id": 16914,
         "description": "94111395",
         "kind": {
           "id": 0,
           "name": "Blood: CBC"
         },
         "status": {
           "id": 2,
           "name": "In Review"
         },
         "sent_to_lis": false,
         "started_at": "2021-12-27T13:03:38.718838+03:00",
         "duration_sec": 632
       },
       {
         "test_id": 16913,
         "description": "9919268438",
         "kind": {
           "id": 0,
           "name": "Blood: CBC"
         },
         "status": {
           "id": 2,
           "name": "In Review"
         },
         "sent_to_lis": false,
         "started_at": "2021-12-27T12:58:24.264011+03:00",
         "duration_sec": 190
       },
       {
         "test_id": 16912,
         "description": "9919266523",
         "kind": {
           "id": 0,
           "name": "Blood: CBC"
         },
         "status": {
           "id": 2,
           "name": "In Review"
         },
         "sent_to_lis": false,
         "started_at": "2021-12-27T12:38:38.224161+03:00",
         "duration_sec": 200
       }
     ]
   }
   ```
4. <https://app.celly.ai/api/lis/v1/analysis/{test_id}> - provides results for the given test\_id&#x20;
   * GET: returns results (format is described below)&#x20;
   * PATCH: returns results + marks the test as submitted to LIS (`sent_to_lis=True`)

Analysis result format:

```
"test_id" – unique test id in the Celly.AI database
"sent_to_lis" - is test marked as submitted to LIS? (bool)
"created_at" – created date (string)
"finished_at" – finished date(string)
"description" –  test description. Slide id from LIS will be here (string)
"conclusion" – conclusion text (string)
"kind_id" –  test type id
"status_id" - test status id
"user" –  user that performed the test (string)
"flags" –  report flags (json)
"snapshots"  - snapshot urls (array of strings)
"cell_counts" – cells number and images (json)
"tiles" - array of slide scan tiles (json) 
```

Result example (CBC test)

```
{
   "test_id":16914,
   "lis_id":null,
   "sent_to_lis":false,
   "created_at":"2021-12-27 10:03:38.448056+00:00",
   "finished_at":"2021-12-27 10:14:10.965686+00:00",
   "description":"94111395",
   "conclusion":null,
   "kind_id":0,
   "status_id":2,
   "user":"Dialab",
   "snapshots":[
      "https://cdn.celly.ai/website/media/app/...",
      ...
   ],
   "marked_cells":[
    { 
        "name": "Monocyte", 
        "comment": "check the cell", 
        "url": "https://cdn.celly.ai/website/media/app/..." 
    }, 
    ...
    ], 
    "tiles":[
       "https://cdn.celly.ai/website/panorama/deepzoom/0/0_0.jpg...",
       "https://cdn.celly.ai/website/panorama/deepzoom/1/0_1.jpg...",
       ...
       ],
   "cell_counts":{
      "backend":[
         {
            "name":"Segmented Neutrophil",
            "count":63,
            "ratio":70,
            "images":[
               "https://cdn.celly.ai/website/media/app/...",
               ...
            ]
         },
         ...
         {
            "name":"Total",
            "count":90,
            "ratio":100
         },
         {
            "name":"Unclassified",
            "count":8
         }
      ],
      "rbc_size":[
         {
            "name":"Normocytosis",
            "count":294,
            "ratio":98,
            "images":[
               "https://cdn.celly.ai/website/media/app/...",
               ...
            ]
         },
         ...
         {
            "name":"Total",
            "count":300,
            "ratio":100
         }
      ],
      "rbc_color":[
         {
            "name":"Normochromia",
            "count":300,
            "ratio":100,
            "images":[
               "https://cdn.celly.ai/website/media/app/...",
               ...
            ]
         },
         ...
         {
            "name":"Total",
            "count":300,
            "ratio":100
         }
      ],
      "rbc_shape":[
         {
            "name":"Normal",
            "count":288,
            "ratio":100,
            "images":[
               "https://cdn.celly.ai/website/media/app/...",
               ...
            ]
         },
         ...
         {
            "name":"Total",
            "count":288,
            "ratio":100
         },
         {
            "name":"Unclassified",
            "count":12
         }
      ],
      "rbc_inc":[
         {
            "name":"Parasites",
            "count":215,
            "ratio":71.7,
            "images":[
               "https://cdn.celly.ai/website/media/app/...",
               ...
            ]
         },
         ...
         {
            "name":"Total",
            "count":300,
            "ratio":100
         }
      ]
   },
   "flags":{
      "wbc":{
         "Megaloblasts":0,
         "Neutrophil hypersegmentation":0,
         "Toxic granulation of neutrophils":0,
         "Erythro, normoblasts":0
      },
      "plt":{
         "Giant PLT":0,
         "Clumps":0
      },
      "rbc":{
         "Anisocytosis":0,
         "Microcytosis":0,
         "Macrocytosis":0,
         "Anisochromia":0,
         "Hypochromia":0,
         "Hyperchromia":0,
         "Poikilocytosis":0,
         "Kodocytes":0,
         "Schizocytes":0,
         "Spherocytes":0,
         "Ovalocytes":0,
         "Teardrop":0,
         "Stomatocytes":0,
         "Acanthocytes":0,
         "Echinocytes":0,
         "Drepanocytes":0,
         "Parasites":0,
         "Cabot rings":0,
         "Howell-Jolly bodies":0,
         "Pappenheimer bodies":0,
         "Basophilic stippling":0
      }
   }
}
```

You can try the API out at Swagger documentation page <https://app.celly.ai/docs/lis>


# Motorized stage connection CX-23

Celly motorized stage setting up instruction for Olympus CX-23

{% embed url="<https://youtu.be/XNeMHcBQwfY>" %}

Main steps:

1. Remove manual stage and focus knob
2. Connect the focus module
3. Connect XY-stage
4. Connect control unit

{% hint style="info" %}
In modern models, the control unit is integrated into the focus module
{% endhint %}

<figure><img src="/files/kDIrvN6quS2ZY7N2rDO2" alt=""><figcaption><p>Components of the set: motorized stage, tray and control unit (integrated with focus module)</p></figcaption></figure>

### 1. Remove manual stage and focus knob

![](/files/xdCGqoOBJLRd5y9V7gta)

Initial state.

![](/files/iKfYqibEuJhAudYpHkBk)

Unscrew 3 screws at the base of the manual stage to remove it.

![](/files/viClXdHtV50MC5zuEyTC)

Unscrew 4 screws at the stage-holder to remove plastic handle.

![](/files/ZGhSW81pU8ZiwFNKDjqJ)

Manually unscrew the right fine focus knob.

### 2. Connect the focus module

![](/files/lAcQRaMTrczwr9hJfBoA)

Focus module, 4 screws and a screwdriver. Top rectangle - z-axe connection place, bottom rectangle - microscope backside connection place.

![](/files/6XbT1I9dS3nciTEPqTSo)

Slide the shroud off and put the motor clutch on the knob screw.

![](/files/wXCq1GhqLhucjFwIC9Fq)

Connect the module to the microscope backside using 4 screws.&#x20;

![](/files/MHGxtggy9JEAql8l59vz)

Microscope backside after the module connection.&#x20;

Finally, tighten the screws on the motor clutch and close the shroud.

### 3. Connect XY-stage

![](/files/lXqiUZHJ5j2mODiQJjCO)

XY-stage, 3 screws, screwdriver. Rounds: connection area, platform ledge.&#x20;

Connect the module to the manual stage place using 3 screws.&#x20;

{% hint style="info" %}
On the Olympus CX-21, the screws are screwed into the bottom of the stage.
{% endhint %}

![](/files/Mi1lXMOmGUbb6TEjYgFr)

Make sure that the platform ledge falls into the focus module groove.

### 4. Connect control unit

![](/files/HtZAMEW6PPOY3qvZsrDT)

Connect signal cables to the control unit matching the red dots on the cable and connector.&#x20;

![](/files/sK2tDcdsnhBSlglyCFNV)

Connect the power cable and turn on the control unit. &#x20;

![](/files/ks5Bm7YfetNPLAHFkDkT)

Almost done! Let's check the CBC test. Set blood smears in the tray (thin part away from you), apply oil to the center of the slides.

{% hint style="info" %}
Before the app launch move up the stage to 100x lens level
{% endhint %}

Open the Celly App -> configure analysis -> Type = Blood (CBC).&#x20;

Check the settings (gear icon):&#x20;

* number of cells: 100-120&#x20;
* sensitivity: 65-75%&#x20;
* crop: 0.15-0.20&#x20;
* minimap: Off&#x20;
* Motorized Stage: On (can require app restart)
* Motorized Slide Scan: Off&#x20;
* Adapter: Other&#x20;
* Recording: Off

Start your test 🔴 and enjoy automation!


# Motorized stage connection

Celly motorized stage setting up instruction

Main steps:

1. Remove manual stage
2. Connect the focus module
3. Connect XY-stage
4. Connect control unit

### 1. Remove manual stage

![](/files/xdCGqoOBJLRd5y9V7gta)

Initial state.

Remove the condenser.

![](/files/iKfYqibEuJhAudYpHkBk)

Unscrew 3 screws at the base of the manual stage to remove it.

![](/files/viClXdHtV50MC5zuEyTC)

Unscrew 4 screws at the stage-holder to remove plastic handle.

### 2. Connect the focus module

Fix the focus module on the focus knob with clamp tie

![](/files/tBIWQ0xOKoqxqKcEunwM)

Push the motor towards the microscope for coupling with the fine focus handle

{% hint style="warning" %}
Do not press too hard, otherwise the grip will deteriorate
{% endhint %}

![](/files/1DqmHo3PRoPcqiTuQ20t)

Tighten motor screws and close the focus block with the end cap.

### 3. Connect XY-stage

Connect the module to the manual stage place using 3 screws.&#x20;

{% hint style="info" %}
On  different microscopes screw position can vary - let us know what version of microscope do you use before the stage purchase
{% endhint %}

Move the stage vertically with focus knob so that the distance from the 100 lens to the glass is 3-5 mm

<figure><img src="/files/zIDWODeO3rR0gBPqfR6k" alt=""><figcaption></figcaption></figure>

Attach the green sensor to the microscope so that it is located directly under the black strip of the stage.

<figure><img src="/files/UhcGr9VZtyaTv2C0zFQK" alt=""><figcaption></figcaption></figure>

Using the fine focus knob, lift the table so that the distance between the bar and the sensor is 2-3 mm.

### 4. Connect control unit

Connect signal cable to the control unit and to the stage.

&#x20;![](/files/Q573Vyd5QYI1yCWSQOgo)

Connect the power cable and turn on the control unit. &#x20;

Done! Let's start [automated CBC test](/supported-tests/blood-wbc-differential).&#x20;


# Barcode reader connection

Barcode reader allows you to scan slide barcodes instantly

Your goal is to pair the scanner with your iOS device. You can connect scanner with Bluetooth support.

{% hint style="info" %}
Honeywell readers with Bluetooth support: 8670 Ring scanner, Voyager 1452g, Voyager XP 1472g, Voyager 1602g, Xenon 1902, Xenon XP1952g, Granit 1911i, Granit 1981i, Granit XP 1991i SR/XR, 8680i, 8690i
{% endhint %}

* Scan the 'PAPBTH' bar code to unpair the scanner from the base:

<figure><img src="/files/Nu9p8QNJ674CXZH64lRQ" alt=""><figcaption><p>Code for Honeywell 1452G. Find barcode for your reader in the manufacturer's instructions</p></figcaption></figure>

* Look up in the 'Settings' menu of the Apple device the option for Bluetooth.
* Once activated, a list of Bluetooth devices that are nearby should appear, from this list, select the device that has the name 'model\_name>\_\<model\_no>\_SN\_\<serial\_number>'.
* The device should be connected to the iOS device. In order to test, open Celly App -> Configure test -> Description and scan a bar-code. The bar-code should appear on the device.

Source - <https://support.honeywellaidc.com/s/article/How-to-get-the-scanner-connected-to-an-Android-iOS-device?topicId=0TOA0000000Tp2rOAC&topicName=Bar%20Code%20Scanners>&#x20;


