Folder Structure in Cloud Projects

Overview

Cloud projects have a slightly different folder structure than local projects.

For Gemini Terrain to keep track of which files and directories are associated with the project at any time, it is strongly recommended to do as much organization as possible directly in the program, not in Windows Explorer. For this reason, the standard location of the local copy of cloud projects is no longer on C:\users\Gemini\Ter\Data, but in the hidden directory %localappdata%\Gemini\CloudCache.

In Gemini Terrain Settings - Project - Project Folders - Synchronized Folders... we can choose which folders to include in the synchronization. Under File - Include files in cloud project we import files to the directory structure as set up in Synchronized Folders....

Synchronized Folders

In the Synchronized Folders dialog, you specify which directories should be included in the project. New directories are added using the Add... button. The table lists all specified directories.

Note

It is only possible to add directories that are at the same level or lower than the .prj file. It is therefore not possible to retrieve directories from a completely different location on the computer or from other server locations.

The dialog has four columns:

• Name:
  The directory name as specified in Windows Explorer
• Gemini Terrain:
  Specifies whether files in this directory should be uploaded to Gemini Connected, or downloaded from Gemini Connected if the client is Gemini Terrain
• Gemini 3D Field:
  Specifies whether files in this directory should be uploaded to Gemini Connected or downloaded from Gemini Connected if the client is Gemini 3D Field
• Recursion:
  If this checkbox is selected, all subdirectories will behave the same as the top level.

Dialog for synchronized folders with different upload and download rules and recursion enabled for selected folders

In the example above, we see the project's root directory Demo-Nor. All files in the root directory will be synchronized to and from Gemini Connected when working in Gemini Terrain, and all files in the root directory will be downloaded to Gemini 3D Field. The root directory cannot be removed from the project, which we can see from the Remove button being disabled when the root directory is selected. Pictures and Field Registration are the two other directories that always accompany a project in Gemini Terrain.

In addition to the standard directories, some extra directories have been added in the example above. Road model is added, and recursion is enabled. This means that all subdirectories, in this case, Own roads, From consultant, and Sketches are automatically added with the same rules. If you create one or more new subdirectories for Road model, these will also automatically be added with the same rules: Upload and download data in Gemini Terrain, and download data to 3D Field.

Under Road model with its subdirectories, a directory named Machine Control has been added. This is set up to neither upload nor download data. However, three subdirectories have been manually added, all of which are instructed to upload data to Gemini Connected. This can be useful for making machine control data available via the web portal, without the data needing to be synchronized down to all Gemini Terrain and Gemini 3D Field clients. If you create a new subdirectory to Machine Control, it will not automatically appear in the list, as Machine Control is not specified with recursion.

The Remove button is used to stop selected folders from synchronizing data with the cloud. If you remove a directory that has been added with recursion, all its subdirectories will also be removed. You cannot individually remove subdirectories that are in a directory that has been added with recursion. If you add a directory that is not at the top level of the project, the entire tree structure up to the root directory will be listed, but the unwanted levels up to the root will be set to neither upload nor download data. The reason they are listed anyway is to make it easier to have an overview of the directory structure. The directories that make up this tree structure cannot be removed until you remove the directory at the lowest level.

The Change button is used to move the pointer from one directory to another. The rules for uploading and downloading are maintained for the new directory.

Include Files in Cloud Project

To ensure that files are correctly imported, it is recommended to use the Include files in cloud project... dialog, which you can find on the File menu. This dialog inherits its appearance from Manage synchronized folders..., described above.

Procedure

1. Select the directory you want to import files to
2. Click Import files...
3. Select the files you want to import (you can select multiple files at once)
4. Click Open to import the selected files