> For the complete documentation index, see [llms.txt](https://help.connected.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.connected.illumina.com/dragen-stratamap/illumina-spatial-image-tool/troubleshooting.md).

# Troubleshooting

## Retrieving Log Files for Illumina Support

If you encounter a problem while using the **Spatial Image Tool**, the Illumina support team may request a log file to help troubleshoot the problem. Follow the steps below to locate and send the correct log file from your system.

***

### Locate the Log File

The application creates a new log file every day. These files are named using the format `YYYY-MM-DD.log` and are stored in a system folder on your computer.

#### On Windows

1. Open **File Explorer**.
2. In the address bar, paste the following path and press Enter:

   ```
   %APPDATA%\Illumina Spatial Image Tool\logs\
   ```
3. Find the file named:

   ```
   YYYY-MM-DD.log
   ```

   \
   Replace `YYYY-MM-DD` with the date the issue occurred.

***

#### On macOS

1. Open **Finder**.
2. Press `Cmd + Shift + G` to open the “Go to Folder” dialog.
3. Enter the following path:

   ```
   /Users/<your username>/Library/Logs/Illumina Spatial Image Tool/
   ```
4. Locate the file named:

   ```
   YYYY-MM-DD.log
   ```

   \
   Replace `<your username>` with your macOS username and `YYYY-MM-DD` with the date the issue occurred.

***

### Send the Log File

Once you’ve located the log file:

1. Attach it to your support message.
2. Include a brief description of the issue and the steps that led to it.
3. Send the message with the log file.

## Spatial Image Tool Cloud Export Failure

In the event that the Spatial Image Tool cloud export feature fails, use the following instructions to upload your OME-TIFF files directly to ICA for autolaunch or manual analysis. Additionally, you will need to create a corresponding sample sheet that contains the cloud locations of the OME-TIFF files.

1. After processing your images with the Spatial Image Tool, be sure to save the exports locally.
2. In a browser, navigate to your ICA domain and enter the desired Project.
3. Upload the OME-TIFFs for all samples to ICA using the user interface tool.

{% hint style="info" %}
Where you decide to upload the OME-TIFFs is flexible. Choose a location that works for you.
{% endhint %}

<figure><img src="/files/5N9SGZvbUf0f9o6YTfKP" alt=""><figcaption></figcaption></figure>

4. Once the OME-TIFFs are successfully uploaded, save the URNs associated with each one:
   1. Select the name of the OME-TIFF to open the Data details.
   2. Find and copy the entire URN of each sample (note: the entire URN is longer than what appears here, so make sure to highlight as far as you can to the right to copy all characters):

      <figure><img src="/files/l5CNvAQ4XVhSSjgvZ5tx" alt=""><figcaption></figcaption></figure>
5. On your computer, navigate to and open the **samples\_for\_substrate.csv** that was locally exported from ISIT and is relevant to the substrate you'd like to analyze.
6. Paste the URN associated with each OME-TIFF file into the CSV in the appropriate column.
7. Save the new CSV somewhere easily accessible on your computer.
8. In a browser, navigate to BSSH and create a sample sheet using the Run Planning Tool.
   1. When importing samples, use the "From this Computer" option.
   2. Upload the samples\_for\_substrate.csv that was created in steps 5 through 7.
9. Proceed as you normally would with [autolaunch](/dragen-stratamap/dragen-spatial-transcriptome/run-setup.md) or [manual launch](/dragen-stratamap/dragen-spatial-transcriptome/run-setup/ica-manual-launch.md).

## Registration failure

To enable image registration, the software detects the tissue area and searches for fiducials around it. Registration can fail when the auto-generated tissue mask is substantially incorrect. In these cases, you can edit the mask to define the tissue area, then repeat image registration. To edit the mask, this select the edit icon next to a sample that failed registration

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

{% hint style="info" %}
Most registration failures are not caused by an incorrect tissue mask. Editing the mask only helps when the tissue mask caused the failure. It is unlikely to help when the existing mask is mostly correct.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.connected.illumina.com/dragen-stratamap/illumina-spatial-image-tool/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.