The CityEngine Workspace

The central hub for your files is called the workspace. You can think of the Navigator as a tool that allows the user to navigate and manipulate the workspace. The Navigator provides operations for creating, navigating, and manipulating files and folders in the workspace.

There is exactly one workspace open at a time, and it is always open as long as the CityEngine is running. The workspace is opened automatically when CityEngine starts up and the previous window configuration is restored.

The workspace contains a collection of resources. There are three different types of resources: projects, folders, and files. A project is a collection of any number of files and folders. It is a container for organizing other resources that relate to a specific CityEngine project. Files and folders are just like files and directories in the file system. A folder contains other folders or files.

A workspace's resources are organized into a tree structure, with projects at the top level, and folders and files underneath. A workspace can have any number of projects, each of which can be stored in a different location in some file system.

The workspace resource namespace is always case-sensitive and case-preserving. Thus the workspace allows multiple sibling resources to exist with names that differ only in case. The workspace also doesn't put any restrictions on valid characters in resource names, the length of resource names, or the size of resources on disk. Of course, if you store resources in a file system that is not case-sensitive, or that does have restrictions on resource names, then those restrictions will show through when you actually try to create and modify resources.


  1. Creating a new Workspace
  2. Switching Workspaces

Copyright ©2008-2016 Esri R&D Center Zurich. All rights reserved.