Guide to Analysis on NaN Cluster (King's College London) - Neurocraft/neurocraft GitHub Wiki
Guide to Accessing Neuroimaging Analysis Network (NaN)
Prerequisites
Before accessing the NaN platform, ensure you have the following:
- VPN Connection to KCL Intranet: As a first step you need to connect to King's intranet. The links below are not accessible outside of KCL's network perimeter.
- Neuroimaging Analysis Network (NaN) Account: Create an account at NaN for accessing various neuroimaging tools and resources. For account creation and more information, visit NaN Accounts.
- Remote Desktop with NoMachine: Install and configure NoMachine for remote desktop access. Learn more about setup and usage at NoMachine Guide.
File Sharing and Data Transfer
To perform the analysis, it's essential to copy the applications and the data for analysis to the remote computer. Cyberduck is a recommended tool for this purpose. You can download it from Cyberduck's official website.
Setup connection to NaN server
-
Open a New Connection: Click on
Open new connection
. -
Configure the Connection:
- Choose
SFTP (SSH File Transfer Protocol)
from the dropdown. - Enter your credentials (username and password) for the remote server.
- Choose
-
Access Remote Desktop
- Once connected, a new disk labeled
desktop.nan.kcl.ac.uk
will appear. - Click on this disk to access the file system of your remote desktop.
Transfer Files
- You can now drag and drop files from your local computer to the remote desktop.
- The files you need to transfer include:
- MATLAB Application Files: Upload the provided MATLAB file. This file must be added to Matlab's path on the remote computer for the applications to work (see run the applications).
- Data for Analysis: Upload these files to a separate folder designated for data.
By following these steps, you'll be able to efficiently transfer necessary files and data to your remote desktop for analysis.
Start Matlab on Remote Desktop
After establishing a connection to your remote desktop, follow these steps to start MATLAB. This process involves a few extra steps beyond the usual method.
-
**Connect a processing machine via
Nan Terminals
**- Navigate to
Applications -> Nan Terminals
. - Choose a terminal from the available options (see figure: left hand side). This selection connects you to a machine powerful enough to run your analysis.
- Your NaN desktop acts merely as an entry point to these instances. Once you select a terminal, you interact with it through a terminal window (see figure: central window).
- Navigate to
-
Launch MATLAB:
- In the shell window of the terminal, type commands to start MATLAB running on the selected machine.
- Enter the following commands: \
>>> module load matlab/latestmatlab >>> matlab
- Wait for MATLAB to start.
Run the Applications
To run the applications on MATLAB, follow these steps:
-
Add MATLAB Folder to Path: Add the MATLAB folder, which contains the applications and was previously copied to the remote desktop, to MATLAB's path.
-
Start the Applications: Simply type
Gazelle
orCoconi
in MATLAB's command window to launch the applications.
❗️If the application windows are not within the visible area of your desktop, you can reposition them. Right-click on the MATLAB window, hover over the window of the application you want to move (e.g., Gazelle or Coconi), and select move to bring it to a convenient area on the desktop.