Managing Leapfrog Geo Projects
Once you have signed in to Leapfrog Geo using your Seequent ID, the Leapfrog Geo main window will appear with the Projects tab displayed. The Projects Tab is used for organising your Leapfrog Geo projects.
Three types of projects will be listed in the Projects tab:
- Projects marked with the symbol are local Leapfrog Geo projects not connected to Central. Click on a local Leapfrog Geo project to open it.
- Projects marked with the symbol are local copies of Central projects. Click on a local copy to view the Central project’s history. Until you are connected to the project’s Central server, the history will be blank. You can open the local copy and connect to its Central server by clicking on the thumbnail in the history tab. See Downloading a Local Copy of a Project in the Central Projects topic for more information on local copies.
- Projects marked with the symbol are the Central projects themselves. These will only appear in the list when you are connected to a Central server. Click on a Central project () to view its history.
The rest of this topic describes how to work with Leapfrog Geo projects. It is divided into:
- About Leapfrog Geo Project Files
- The Projects Tab
- Creating New Projects
- Recording a Coordinate System
- Opening Projects
- Upgrading Projects
- Changed Objects Warning
- Missing Data Warning
- Saving, Backing Up and Compacting Projects
- Tracking Project Work Using Reference Codes
Leapfrog Geo stores two types of projects locally:
- Leapfrog Geo projects not connected to Central
- Local copies of Central projects, which are stored in the location specified in the Settings window (Projects > Central Projects - Local)
In both cases, the project files use the extension .aproj:
A project also has a project folder that contains information used by the project. This is named using the project name and the suffix .aproj_data.
Do not change the name of your .aproj_data folder or alter its contents. Doing so could render your project file unusable.
A .lock file is created when a project is opened. The .lock file protects the project from being moved while the project is open and from being opened by another instance of Leapfrog Geo, which can happen when projects are saved on shared network drives.
Leapfrog Geo is designed for working from your workstation's local file storage. Do not use network file storage, external drives connected by USB or synced cloud storage services (such as Dropbox or Google Drive) as the working location for projects; using these can irretrievably corrupt projects and will dramatically reduce performance.
For managing and sharing projects in a centralised and controlled manner, use Seequent Central. It provides a reliable and safe way to sync your working projects to your local workstation storage.
After you have signed in using your Seequent ID, the Leapfrog Geo main window will appear with the Projects tab displayed.
The Central servers you have access to via your Seequent ID are shown in the Central dropdown menu:
If a server you expect to see does not appear in the list, click the refresh button ().
Click on a server to connect to it.
The stripe under the Central menu shows your connection status. For example, the blue stripe above indicates Leapfrog Geo is not connected to a Central server. Here the stripe is green, indicating that Leapfrog Geo is connected to a Central server. Clicking on the menu displays more information, including an option to disconnect from the server ():
The stripe will be red when there is a connection error and orange if you are connected to a Central server as part of a trial programme.
More information is shown in the Central dropdown when Leapfrog Geo is connecting to a server or publishing an update to the server. In this example, Leapfrog Geo is in the process of connecting to a server:
When you first start Leapfrog Geo, the Projects tab lists all projects you have access to without connecting to a Central server. Here Morgan Playa has access to three local projects () and a local copy of a Central project ():
You can view the list of projects as thumbnails, as shown above, or as a list. The list view shows more information about each project, such as the date the project was last modified, the file location for local projects and the Central server for local copies of Central projects.
The folder the Projects tab searches for local projects can be changed by clicking on the Settings button:
In both the thumbnail and the list views, click on the overflow menu () for more project-related options:
Connect to a Central server by clicking on the server button and selecting from those in the list:
Once connected, the list will be updated to show the Central projects available on that server, along with local projects:
Use the Search box to filter the list of projects.
When not connected to a Central server, the list may show local copies of Central projects from multiple Central servers. Once connected to a server, only Central projects from that server are listed.
As with the local copies of the Central projects, clicking on the Central project will open its history.
A Central project is the history of a Leapfrog Geo project tracked through time, organised into revisions. In Leapfrog Geo, you can view the history of a Central project, and you can download local copies of these revisions and work on them in Leapfrog Geo. Here, the history of a Central project called “Castle Hill” is shown, and there are two local copies of that project, one that was modified on the 16th of November 2021 and one that has not been modified since it was downloaded (Unchanged):
Click on a thumbnail to open a project, which will automatically connect you to the project’s Central server.
There are two ways to create a new Leapfrog Geo project. You can:
- Click the New button in the Projects tab
- Select New Project from the Leapfrog Geo menu
In the New Project window, enter a name for the new project and, if you want it to be a Central project, enable the Central Project option:
The Central Project option is only available when you are connected to a Central server. If you want to create a Central project on another server, you need to connect to that server first.
When you create a new Central project, a new project will be created on the Central server and a local copy will be created and saved in the location specified in the Settings window (Projects > Central Projects - Local). Leapfrog Geo will open that local copy and you can start working in it right away, and when you are ready to publish the first revision, initiate the process as described in Initiating a Publish Event.
To create a local project, disable the Central Project option. The project will be saved in the location specified, but if you want to change it, you can do so by clicking on the folder button and navigating to a different folder.
Leapfrog Geo will open the project and you can start working in it right away.
Leapfrog Geo is unit-less and adopts the units used in the data you import. For example, if your imported data is in metres, the units displayed will be metres, and figures such as resolution, measured distances and slicer thickness will be in metres. It is important, therefore, to be consistent in the units used in the data you import. If you are importing data that uses different coordinate systems, you will need to pre-process the data so that it is using the same coordinate system.
In order to communicate to the wider team, you can record in each Leapfrog Geo project the coordinate system that should be used, which will then be displayed at the bottom of the Leapfrog Geo window:
The Projected Coordinate System is for information only. Leapfrog Geo will not convert any data that is imported with references using a different coordinate system into the project coordinate system, nor does changing the project coordinate system perform a conversion of the data within Leapfrog Geo from the previous coordinate system to the new coordinate system.
The Projects tab will show the project coordinate system metadata setting in the Coordinate system column when the projects are displayed in the List view:
To record and display the coordinate system team members should be using in a project, click on the button at the bottom of the Leapfrog Geo window:
The Settings window will open with the Coordinate System tab displayed. Click the Modify button to see a comprehensive list of projected systems (not geographic systems). This list is based on the EPSG registry.
The Name and Well-known ID fields are not editable; these are changed automatically according to the coordinate system selected in the list. The Local Datum Transform and Units fields may contain additional options besides the default values for the selected coordinate system, and these can be selected as an option. Above the list is a search box, and what you enter there will be used to filter the list of systems:
Click the Save button to record the information, which will then be displayed at the bottom of the Leapfrog Geo window.
The Projected Coordinate System setting is primarily an informational field. The project coordinate system should be set when the project is created and all the data imported into Leapfrog Geo should use the coordinate system that has been decided on for the project. Leapfrog Geo will not convert any data that is imported with references using a different coordinate system into the project coordinate system, nor does changing the project coordinate system perform a conversion of the data within Leapfrog Geo from the previous coordinate system to the new coordinate system.
From the Projects tab, click on a thumbnail to open a project. You can also navigate directly to the required project file by clicking on the Open Project button.
If when you open a project you get a message saying that the project contains restricted objects, this is because one or more objects were creating using Leapfrog Geo features available in an extension you did not sign in with. Click Show restricted objects to view the affected objects. See Restricted Objects in The Project Tree topic for more information.
Once a project file has been opened, Leapfrog Geo switches to displaying the Scene View tab. See An Overview of Leapfrog Geo for a description of the different parts of the Leapfrog Geo main window.
When you open a project that was last saved in an earlier version of Leapfrog Geo, you will be prompted to upgrade the project and a list of affected objects will be displayed. As part of this process, you will also be prompted to create a backup:
Backing up before upgrade is compulsory for local projects and local copies of Central projects; you cannot open the project without first creating the backup. You can choose between a processed or an unprocessed backup:
- A Processed backup includes all stored modelling calculations. This can result in large file sizes, but when the backup is opened, no reprocessing will be required.
- An Unprocessed backup removes all stored modelling calculations. This can reduce the size of the backup, but if the backup is needed, all of the modelling calculations will need to be reprocessed from the underlying data.
The tradeoff is that when an unprocessed backup is selected, the backup can be completed quickly and the resulting file size will be smaller, but when the backup is needed, reprocessing might take some time, especially with large, complex projects.
Select the option required, then click OK. You will be prompted to select where the backup should be saved. Once the backup is complete, the project will be opened and upgraded.
If the project has been downloaded from Central and has not been changed, there will be a third option, to upgrade the project without creating a backup:
If the project being upgraded contains objects that could change as the result of the upgrade, there will also be a Create copy of changed objects option in the Project Upgrade window:
This option is described further in Changed Objects Warning below.
Upgrades can sometimes result in changes to objects, and for this reason, Leapfrog Geo gives you options for saving copies of pre-upgrade surfaces, along with information about which objects in the project have changed due to the upgrade. When you upgrade a project, Leapfrog Geo will prompt you to:
|Save a copy of changed surfaces in the Meshes folder. This prompt is shown in the Project Upgrade window.|
|Highlight the changed objects in the project tree. Once the project has been upgraded and opened, a link is displayed that allows you to highlight all changed objects in the project tree.|
|Save a text file with a list of changed objects. This prompt is included in the window that contains the link to changed objects.|
When the Create copy of changed objects option in the Project Upgrade window is enabled, the folder created in the Meshes folder will contain non-editable copies of the pre-upgrade surfaces that link to the upgraded surfaces. For example, here the pre-upgrade mesh () in the Meshes folder is linked to the upgraded surface that is part of a geological model ():
Whether or not you enable Create copy of changed objects in the Project Upgrade window, once the project has been opened, a message will be displayed that includes a link to the changed objects and gives you the option of saving a file containing the list of changes:
The text file and any pre-upgrade meshes can be used in investigating changes to surfaces. For example, here we can see that the non-editable copy of the pre-upgrade mesh () (shown in blue) does not match the upgraded geological model surface () (shown in triangles):
Looking in the text file, we can see that the points used to create the surface have been upgraded and so we can check what has changed about those points:
When a project is opened, Leapfrog Geo checks the integrity of the project, looking for missing data. In some cases, Leapfrog Geo can try to open the project and you may be able to continue working in it.
In other cases, Leapfrog Geo can attempt to generate the missing files from data in the project, in which case you will be asked whether or not you wish to repair the project.
Whatever the case, read the information in the dialog and decide whether you wish Leapfrog Geo to open the project or attempt a repair.
It is strongly recommended that you allow Leapfrog Geo to back up a project that has files missing before attempting to open or repair it.
This message may be displayed if:
- You have copied a project to a different folder and the copying process is not yet complete
- You are unzipping a project and the process is not yet complete.
If this is the case, click Cancel and try opening the project again once the copying/unzipping is complete.
Leapfrog Geo automatically saves an open project each time a processing task has been completed or settings have changed. Projects are also saved when they are closed.
You can also save a copy of a project, save a zipped copy of a project and compress a project. These options are available from the Leapfrog Geo menu:
- Save A Copy. This option is only available for local projects. Save a backup copy of your project to a location on your hard drive. You will be prompted to choose a new name and location for the saved project. Click OK to create the new project file. Leapfrog Geo will save a copy of the project in the location selected. Once the backup copy is saved, you can open and use it from the Projects tab. Otherwise, you can keep working in the original copy of the project.
- Save A Zipped Copy > Processed. Saves a zipped copy of a project that includes all stored modelling calculations. This can result in large file sizes, but when the backup is opened, no reprocessing will be required. You will be prompted to choose a name and location for the zipped project. Click Save to create the zip file.
- Save A Zipped Copy > Unprocessed. Saves a zipped copy of a project without stored modelling calculations. This can reduce the size of the backup, but if the backup is needed, all of the modelling calculations will need to be reprocessed from the underlying data. You will be prompted to choose a name and location for the zipped project. Click Save to create the zip file.
- Compact This Project. When you delete objects from a project file, Leapfrog Geo retains those objects but notes that they are no longer used. Over time, the project file will grow in size and data stored in the database may become fragmented. Compacting a project removes these unused objects and any unused space from the database. When you compact a project, Leapfrog Geo will close the project and back it up before compacting it. Depending on the size of the project, compacting it may take several minutes. Leapfrog Geo will then reopen the project. When you select this option, you will be asked to confirm your choice.
You can enter a reference code to track work on specific projects. The time associated with each reference code is included in your monthly usage report.
To enter a code, click the button in the status bar on the bottom edge of the Leapfrog Geo main window:
Select from the codes defined and click OK. The code entered will be displayed in the status bar:
To define new reference codes or delete old ones, click on the Manage Codes button. See Usage Policy Settings.
To work without a code, click on the button, select <No Code>, then click OK. Note that whether it’s possible to use Leapfrog Geo without first entering a reference code depends on a setting in the Settings > Usage Policy window.