Skip to content

Resource View#

Clarisse is built upon a smart memory manager that detects and eliminates, automatically redundant data. This data can be of any kinds so that they are not only limited to geometries and images. These data are called Resources and can represent any arbitrary data that can be potentially shared by the items of the application.

There can be several thousand of resources in a typical production scene. Since Resources are automatically created or loaded during evaluations, Clarisse provides, the Resource View, a dedicated widget to manage and monitor them. The Resource View allows to manage, sort, track and clear resources that are currently in Clarisse memory. It is divided into two parts: the resource toolbar and the resource list.

Resource View

The Resource View

(1) Empty Resource Visibility Toggle (2) Display File Resource only Toggle (3) Show Shared Resources (4) Clear Resource (5) Reload Resource (6) Resource Information (7) Resource Memory Statistic (8) Resource List

Resource List#

The resource list (8) is where resources and their information are displayed. Here, you can sort items either by Path, Class, Tag, Size and Requester Count.

Column Description
Path As Resources have no name, it displays the path of the first item declaring the resource.
Class Object class declaring the resource.
Tag Optional description of the resource.
Size Memory size used by the resource.
Requester Count Number of requester using this resource. The higher the number, the higher the de-duplication.

When you select one or multiple resources, the Resource View selects all items sharing those resources.

Memory Statistics#

The Resource View displays memory statistics related to what is currently loaded in memory. These statistics only cover resource memory consumption. To have more complete statistics please use Help > Log Statistics... or press Ctrl+Shift+F1.

Resource View Stats

Resource count is the total number of resources declared in the memory (empty or not). The Requester count displays the number of items requesting resources. An item can request one or more different resources.

For example, geometries can request over 20 different resources.

At the right is located memory usage statistics. The first digit displays a good approximation of the physical memory used by all resources. The second digit displays the amount of RAM Clarisse would virtually need if there were no de-duplication. Finally the last digit, in percentage, is the ratio between real memory usage over the total virtual memory usage. Lower values mean high level of de-duplication.

Empty Resources#

When an item is created without being evaluated (not rendered or seen...), its resources are likely to be empty since Clarisse allocates data only when necessary. The Hide Empty Resources (1) toggle button allows you to filter the display of declared empty resources in the Resource List (8).

In this scene we've created only an empty implicit Box  It has only empty resources as no widgets required any of its data

In this scene we've created only an empty implicit Box. It has only empty resources as no widgets required any of its data.

Same scene with Hide Empty Resource off We see all its resources are empty Same scene with Hide Empty Resource off. We see all its resources are empty.

After displaying a 3D View showing the Box, 3 of its resources have been automatically created

After displaying a 3D View showing the Box, 3 of its resources have been automatically created.

Renabling Hide empty resource displays only 3 resources

Renabling Hide empty resource displays only 3 resources.

File Resources#

There are two kind of resources: generated resources or resources originating from a file. Using the Resource View you can filter the resource list to display only file resources by clicking on the disk icon (2).

File filter enabled, the Resource View displays only file resources

File filter enabled, the Resource View displays only file resources

If a file has been modified, you can reload file resources at any time and even during an evaluation. To reload one or more resources, just select them in the resource list and press Reload (5). Clarisse reloads files only if they are modified. Alternatively, you can use Reload All (5) to reload any modified file resources or use File > Reload Resources or Ctrl+R.

Clearing Resources#

You can clear any existing resources at any time and even during an evaluation. To clear a resource, either select it in the resource list (8) or select an object in Clarisse using the browser for example.

Then press Clear (3). An easy way to clear all resources used by an item, is to select this item in Clarisse. When you select an object in Clarisse, all its resources are selected in the Resource View.

If you wish to free memory, you can also sort the resource list (8) by memory usage. click on the Size column to sort items in ascending or descending order.

Resources sorted by memory usage

Resources sorted by memory usage

You can also clear all resources that are in memory by pressing Clear All (3).