Upload Analysis

Uploading analysis files to the Csmart cloud platform

The Upload Analysis section consists of two screens: Login for authentication and Upload Files for transferring analysis data to the Csmart cloud platform.

Login

Prerequisites

  • A Csmart cloud account with valid credentials.

  • An internet connection to reach the API server.

Step-by-Step Walkthrough

1. Enter Credentials

On the Login screen, enter your:

  • Email address

  • Password

2. Configure Server (Optional)

By default, the application connects to the Csmart production API. To use a custom server:

  1. Toggle the Custom Server switch.

  2. Enter the custom API address in the field that appears.

  3. The address is saved automatically.

3. Log In

Click Log In. The application authenticates with the API server and, if successful, navigates to the Upload Files screen.

circle-info

Your session persists until you close the application. You do not need to log in again during the same session.

If login fails, a specific error message is displayed (invalid credentials, server unreachable, etc.).

Upload Files

Prerequisites

  • An active login session.

  • One or more analysis files (.hdf5) with classification results.

Step-by-Step Walkthrough

1. Select Files

Click Add Files to browse for analysis files. You can select up to 10 files at a time. Each selected file appears in a list showing its name and detected metadata.

2. Handle Existing Files

If a file with the same name already exists on the server, a confirmation dialog appears with options to:

  • Overwrite the existing file.

  • Skip the file and continue with the next one.

3. Choose Image Inclusion

Toggle Include Images to control whether the full image data is uploaded along with the classification results. Excluding images significantly reduces upload size and time.

circle-info

Uploading without images transfers only the numerical data (features, classifications, metadata). This is sufficient for cloud-based reporting but not for image review.

4. Upload

Click Upload to begin the transfer. A progress indicator shows:

  • Current file being uploaded.

  • Upload percentage for each file.

  • Success or error status per file.

Files are uploaded in parallel where possible.

5. Review Results

After upload completes, a summary shows the status of each file (success, skipped, or error).

Configuration Persistence

The server address (default or custom) is persisted in the Electron Store. Login credentials are not stored.

Troubleshooting

Issue
Possible Cause
Solution

Login fails with "Invalid credentials"

Wrong email or password

Verify your credentials; contact Csmart if you need a password reset

Login fails with "Server unreachable"

No internet or wrong server address

Check your connection; verify the API address

Upload stalls

Large file with images included

Disable image inclusion for faster uploads; check internet speed

"File already exists" for every file

Previous uploads were not completed cleanly

Choose Overwrite or contact the cloud administrator

Upload completes but data not visible

Cloud processing delay

Wait a few minutes; data may take time to appear in the cloud dashboard

Last updated