To start a single simulation in the cloud, enter the simulation parameters as usual in GeoDict by clicking on the Edit button in the module section. After setting up all parameters, click the Cloud button instead of the Run button.
If you are not logged in, the Login to GeoDict Cloud Service window opens. Enter your Username, Password, and your One-time code from the authenticator. Click OK to continue to the Run Command in GeoDict Cloud dialog. If you are already logged in, the Run Command in GeoDict Cloud dialog opens directly.
Run Command in GeoDict Cloud Dialog
The Run Command in GeoDict Cloud dialog offers several settings:
The Project Name allows you to group multiple simulations together by giving them a shared project name. The default name is derived from the name of the currently selected project folder, e.g., MyFirstGeoDictProject.
Important! Results for multiple jobs where both Project and Job Name (e.g., MyFirstGeoDictProject and FiberGeoCreate) are identical should not be downloaded simultaneously since this will result in the same file names and overwriting of files. We recommend to define different Job Names to avoid this problem.
The Job Name Prefix serves to identify the specific simulation that is run. The default name depends on the chosen command, e.g., GrainGeoCreate for creating grains using GrainGeo.
Important! Results for multiple jobs where both Project and Job Name (e.g., MyFirstGeoDictProject and FiberGeoCreate) are identical should not be downloaded simultaneously since this will result in the same file names and overwriting of files. We recommend to define different Job Names to avoid this problem.
When this option is activated the structure that is currently loaded in GeoDict is uploaded to the cloud machine together with the job. This is required for commands which operate on the current voxel structure. This applies to most Analyze and Predict modules. Therefore, this option is active by default when a structure is currently loaded in GeoDict.
When this option is activated the entire current project folder is uploaded to the cloud machine together with the job. This can be necessary if additional files in the project folder are required to run the computation, e.g., for continuing a FlowDict simulation from a previous result. We suggest preparing a new project folder for this purpose, containing only the required data to avoid uploading unnecessary files.
Select the GeoDict Version that you want to use. You can only select the same major version as you are running locally, e.g., GeoDict 2026. However, you can choose between different service packs, if they are available on your cloud environment. Note that this allows you to, e.g., test a new Service Pack release before installing it locally.
Here you can select which type of cloud machine you want to use for the simulation. You can see the Number of (#) cores, the RAM, and what type of GPU is available. To see cloud machines with one or more GPUs, enter a value in the Number of GPUs box. GPUs are necessary to effectively use AI functionalities in GeoDict (e.g., GeoDict-AI, FiberFind-AI). Click in the checkbox of the machine type that you want to use for this job and then click Ok.
Note! Be aware that the Number of Cores shown includes cores available through the use of hyperthreading. That means, a machine with 32 logical cores consists of 16 physical cores. Some GeoDict functionalities cannot efficiently use hyperthreading. Their speed is limited by the ability of the processor to process large amount of data and not by the ability to do many arithmetic operations. Therefore, if you select a machine with 32 cores from the list, the runtimes may be similar for using 16x parallelization or 32x parallelization, as cores available through hyperthreading may not add a significant speedup.
This option allows you to define a timeout for the job in hours. If the job has not completed after the given time, it is automatically terminated. The maximum value is 720 h (30 days). If you do not want any timeout, set this value to 0. Then the simulation runs until it is completed, terminated, or crashes. Setting a timeout can be useful to avoid additional costs, e.g., for simulations that fail to converge.
After defining all settings, click Run to send the simulation job to the cloud. You will then see a dialog showing the progress of packing the job and sending it to the cloud. All your custom GeoDict settings (e.g., your material database) are also automatically packed and sent together with the job. This ensures that the same settings are applied for local and cloud machine simulations.
Depending on your account configuration, the number of simultaneous virtual machine instances might be limited to protect you from accidental overspending. If you submit more jobs than the limit, you will receive an error message during the upload. Although those jobs will be shown as Ready in the GeoDict Cloud Projects dialog, there is currently no functionality to start these jobs. Delete these jobs and wait for other jobs to finish before resubmitting the simulation.
After the upload is completed, the GeoDict Cloud Projects dialog opens automatically. Here you can see the current status of your submitted job as well as all other jobs that you have in the GeoDict Cloud. Press Refresh (or F5) to update the view. You can close the dialog and continue to work with GeoDict locally. Open the dialog any time by selecting Cloud & Queue→GeoDict Cloud Projects in the menu bar. When a simulation is completed, the virtual machine shuts down automatically and the status of the job changes to Completed. You can now download the results.
