Signals Image Artist: How do I upload data into a new Screen using the gemma client?

By passing a unique (not already present in SImA) screen_UUID  during the job submission, a new screen will be created in SImA. The --screen-name parameter can then be used to assign a name to the newly created Screen.

Example syntax:

gemma-client upload --hostname <host> --username <user> --screen-name "<ScreenName>" <screen_UUID> "<data_format>" <path_to_import_data>

Where:

Real-World Example:

gemma-client upload --hostname simaserver.com --username john --screen-name "MyScreen" $(uuidgen) "Harmony IDX/TIF" /mnt/import_data

In the above example the Linux uuidgen program was used to generate the Screen UUID. The uuidgen program creates a new universally unique identifier (UUID) using the libuuid library. Similar UUID generators could be used when working with the gemma-client in a Windows environment.

Note: The password of the mentioned <user> will be requested interactively on job submission. Alternatively, the password can be passed as part of the gemma-client submission using the --password option. 

Uploading on behalf of other users: 

As of SImA v1.2 it is possible to use the admin user account to upload data on behalf of another user using the --owner-username parameter. In that case the syntax looks like this:

gemma-client upload --hostname <host> --username <admin_user> <screen_UUID> "<data_format>" <path_to_import_data> --owner-username <user>

Where the --owner-username parameter is used to pass the <user> account into which the data should be imported.

Real-World Example:

gemma-client upload --hostname simaserver.com --username admin --screen-name "MyScreen" $(uuidgen) "Harmony IDX/TIF" /mnt/import_data --owner-username john

In the above example the admin user uploads the data on behalf of user john.