# Getting Started

### Running your own analysis

#### Making an account

To run your own analysis on iMaps you will need to make a free account. (Alternatively if you just want to browse publically available data you can "Explore as a guest").

To create an account, fill out the information on the home page:

![](/files/V8kiKxyQoQv2h04xVoqe)

You will immediately find yourself in the iMaps interface:

![The iMaps interface.](/files/0bevpRFm1sIDUt8044YE)

Click on the "Upload Data" link in the left-most menu. You can upload any data here, but for a typical Demultiplex and Analyse run, you will need a Multiplexed FASTQ file and an Annotation spreadsheet (XLSX or CSV).

{% hint style="warning" %}
Spaces in file names are not permitted.
{% endhint %}

![The upload portal.](/files/r5d4jDAeq5air4hFn6mL)

Then, I will upload the annotation for my lane, currently you must save and upload this as csv or xls. You can download the annotation template [here.](https://files.imaps.goodwright.com/media/annotation_template.xlsx)

\
Some notes on the annotation - scientist is who did the experiment, both scientist and PI columns need to be the iMaps usernames of these people! These columns are optional in the case that you don't know. The protein/gene name needs to be the official name as found in Ensembl, or one of the other terms allowed in the second spreadsheet of the Excel template. The cell line must also be an official term - you can check the allowed terms in the second spreadsheet in the Excel template. 

{% hint style="info" %}
To request a new term, please post on our Slack workspace in [#request-new-terms](https://app.slack.com/client/T023JE90B3P/C03GX8MSSRH)
{% endhint %}

\
You might have some errors that you need to correct - once the sheet has been validated it will be uploaded.

\
Now to run the main analysis pipeline you need to click on "Run Analysis" in the left-hand menu, followed by the "Demultiplex and Analyse" pipeline. Now you are prompted to add your annotation csv/xls and multiplexed fastq file.

\
For every species you are mapping to you will need to select the genome version - most of the time you will choose the Defaults.

![](/files/7vVKqkBVjEplJ59mdmfP)

After clicking "Run Command" you will be taken to a page where you can follow the progress of your analysis.

![](/files/RSNifkyPa2i0zm0kpQrn)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imaps.goodwright.com/guides/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.