> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oryx.mechatronstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import signals

> Turn an image, photo or screenshot, instrument data or an Oryx file into an editable signal.

You can start a project from an existing signal or bring one into the open project using **Menu → Import** (`Ctrl+I`).

| Source | Files | What happens |
| - | - | - |
| Oscilloscope or logic analyzer image, photo or screenshot | PNG, JPG, WebP, SVG | The converter detects traces and turns them into editable channels and steps. |
| Instrument data | TXT, CSV; the picker also accepts TSV and DAT | The converter reads a time column and one or more signal columns. |
| File exported by Oryx | TXT, CSV, JSON | The browser reconstructs the signal without using the converter. |

The importer also recognizes **Oryx PDFs with an embedded project**, if you have one. An ordinary PDF, or one without that attachment, cannot be turned into a signal. Signal PDF export currently appears as **Coming soon**.

## Create a project from a file

1. Open **Menu → New**.
2. Choose **From an image** or **From a file**.
3. For a file exported by Oryx, choose **Oryx format** in the next window; for instrument TXT or CSV, choose **Equipment data**. Then select or drag in the file. You can also paste it with `Ctrl+V`.
4. Review the preview and confirm. Oryx opens the result in the detected digital or analog mode.
5. Check the channels and edges or points before saving. A noisy image or unclear scale may need correction.

### Images, photos or screenshots

Select the image, photo or screenshot you want to convert as **Main**. Add **Auxiliary** images, photos or screenshots if they show the same signal at another zoom level; they help the converter read details. Only the main image is imported as the signal. You can change the main image before continuing.

### Data files

The file needs **time in the first column**, in increasing order, and at least one channel column. Review these options:

| Option | When to use it |
| - | - |
| **Automatic** | Let Oryx choose digital for 0/1 channels and analog for intermediate values. |
| **Digital** | Convert data into two levels. |
| **Analog** | Rebuild curves from samples. |
| **Time window** | Import only a selected interval by giving its start and end in seconds. |

## Import into the open project

1. Open **Menu → Import** and choose an image or file.
2. Under **How it enters**, choose **Replace all** or **Paste**.
3. For **Paste**, enter the starting pulse and target channels. You can mark the pulse on the signal.
4. Select the file and confirm the result.

**Replace all** substitutes the open project's signal and channels and cannot be undone. Save a copy first if you want to keep the previous state. **Paste** places imported channels into your chosen targets starting at the specified pulse.

The open project keeps its mode: an analog signal cannot enter a digital project. A digital signal can be represented as an analog trace when imported into analog mode.

## Limits and common errors

Images and instrument data use the converter and are subject to [daily plan limits](https://docs.oryx.mechatronstudio.com/en/pricing.md#import-limits). Oryx files are read locally; they count toward the file limit on Basic and Plus, and do not count on Pro.

* If data is missing, check that the first column is time and that at least one numeric channel exists.
* For a long signal, set a **Time window** and import again.
* If you reached the daily limit, open **Projects → View usage** to inspect the previous 24 hours.
* If the converter cannot be reached, check your network and try again. Failed imports do not count toward the daily limit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.