System Configuration Notes

This section describes how to set up the system when running MaRGE for the first time. Before proceeding, ensure that the Red Pitaya and the Host computer are configured properly by following this guide.

First Launch of MaRGE

When running MaRGE for the first time, the session window is displayed. For a detailed description of the GUI, go to this link.

This window contains three key widgets:

1. Scanner Checks – Displays missing configuration files.
2. Information Area – Shows real-time system information.
3. Session and Hardware Tabs – Allows users to configure session parameters.

On the initial launch, you will notice:

1. Errors displayed in the information area.
2. Unchecked scanner checks.
3. and buttons disabled.

These issues stem from missing configuration files. This guide explains how to set them up properly.

Configuring the System Files

MaRGE requires the following eight elements to be configured upon first use:

1. Projects
2. Study Cases
3. Console
4. Gradient Hardware
5. RF Configuration
6. Red Pitaya IPs
7. RF Coils
8. Other Hardware and Software Components

Setting Up Projects and Study Cases

To configure a project or study case:

1. Click on the Project/Study box.
2. The box will be empty initially. Click Add/Delete to create a new entry.
3. A pop-up window appears where you can type the project/study name.
   • Entering an existing name deletes that project/study.

Once added, clicking in the session toolbar should check Projects and Study Cases.

Setting up the Console and Red Pitayas

To configure the console and Red Pitayas:

1. Navigate to the Console tab.

2. Configure MaRCoS settings:
   • Red Pitaya Model: rp-122 or rp-125 (only rp-122 working now)
   • Gradient Board Model: gpa-fhdo or ocra1
3. Add the Red Pitaya IP (configured with a static IP):
   • Enter the IP in the IP box and click Add button.
   • The new Red Pitaya appears in the console tab.
   • Add multiple Red Pitayas if needed (e.g., for MIMO applications, under development).
4. Click Save and then to finalize the setup.
   • MaRCoS and RP IPs should now be checked.

RF Configuration and RF Coils

To set up the RF system:

1. Go to the RF tab.

2. Define key parameters such as:
   • Gyromagnetic ratio
   • Larmor frequency
   • RF dead time
   • LNA gain, used to estimate the noise floor in the baseband.
3. Add RF coils:
   • Enter the RF coil ID and its RF efficiency.
   • Click Add to include it in the configuration.
4. Click Save and Update.
   • RFs and RF Coils should now be checked.
   • Added RF coils will appear in the selection box of the Session tab.

Setting up Gradients and Other Hardware

In the Gradients and Others tabs:

1. Complete the configuration fields based on your hardware setup.
2. Click Save and then Update.

Once all elements are configured:

• All checks should be marked.
• The and buttons become available.

Bash path:

• Use "C:/path/to/git_bash.exe" for Windows
• Use "gnome-terminal" for Ubuntu

Tyger server:

• Specify the host of your Tyger server, if applicable.

Each time MaRGE is opened, the configuration is automatically loaded, allowing the user to proceed directly to the main window. The configuration can be modified and updated at any time to run the scanner with new parameters.