Building Thumbnails and Simplified CGR

This section explains how to build thumbnails and simplified CGRs using the legacy 3D Indexing Server tool.

The CloudView server converter, installed during the 3DSpace Index setup, builds all other 3DSpace Index elements.

This task shows you how to:

Build Thumbnails and Simplified CGR for the Default Index Environment

This section explains how to build thumbnails and simplified CGR using the 3D Indexing Server default Index environment.

Note: To create several environments, edit or delete existing ones, see Use the Index Administration Tool for Advanced Configuration.

Before you begin: For Windows, make sure that Enhanced Security is disabled. See Disable Enhanced Security.
  1. Optional: For Windows, you can:
    • Double-click the Data Reindexation Batch tool on your desktop.
    • Or select the command Dassault Systemes 3D Index Server 3DEXPERIENCE R2022x > Tools > Data Reindexation batch
  2. Go to the required directory.
  3. Run the command: 
    • CATSTART -run "BBDAdminPlayer -EnvName 3DIndex_DefaultEnv -ThumbnailOnly [-retry]" -env Env -direnv "C:\DassaultSystemes\
                R2022x\VolumeSearch\CATEnv"
      On Windows. 
    • ./CATSTART -run "BBDAdminPlayer -EnvName 3DIndex_DefaultEnv -ThumbnailOnly [-retry]" -env Env -direnv "/usr/DassaultSystemes/
                R2022x/VolumeSearch/CATEnv"
      On Linux.

    Attribute Description
    -EnvName

    Specifies the name of the indexing environment created at installation. The default is 3DIndex_DefaultEnv.

    -env

    Specifies the name of the runtime environment. The default is Env.
    -direnv Specifies the runtime environment directory.
    [-retry]

    Optional. Starts the indexing for objects that failed to be indexed previously.

    The indexing runs only on objects, which have been identified in the <index_dir>\IndexRetryList file.

    To reset this list, delete the corresponding file.

Verify the Indexing Status on Windows

This section describes how to follow up your indexing status.

On your desktop, double-click the IndexationReport.html shortcut to display the 3D Indexation Administration report.
The Web page comprises six tabs:
Tab Description
Administration

Displays information on 3D indexing progress.

Advanced Report

Displays detailed information on 3D indexing progress.

Crawler Traces

Displays crawler traces.

Stream Detailed Traces

Displays errors that occurred during the geometry indexing step.

Metadata Detailed Traces

Displays errors that occurred during the metadata indexing step.
About

Provides trademark information about the level and the version of the 3DSpace server you are running.

Verify the Indexing Status on Linux

This section describes how to follow up your indexing status on Linux.

  1. Go to the index directory specified during the installation. The default path is as follows: 

    /usr/DassaultSystemes/R2022x/data/3DIndexes

  2. Open the BBDMonitor folder and open Reporting.html to display the 3D Indexation Administration report.
    Note: The version of the build can be seen in the About tab of the Reporting.html

Use the Index Administration Tool for Advanced Configuration

This section explains how to use the Index Administration Tool, which enables you to add, edit, and delete indexing environments interactively.

Edit an Existing Environment

  1. Start the Index Administration Tool tool using one of the following methods:
    • On Windows, select Start > All Programs > Dassault Systemes 3D Index Server 3DEXPERIENCE R2022x > Tools > 3D Index Environment Administration > 3DIndex Environment Administration.
    • On all platforms, go to the required directory and run the command:

      CATSTART -run "BBDEnvEditor"

    The Index Administration Tool GUI appears.
  2. To edit an existing environment:
    • Double-click the environment alias, or
    • Or select the environment alias, then right-click and select the Edit BBDEnv command,
    • Or select the environment alias, then select the Edit > Edit command.

    The BBDEnv Editor dialog box appears.

  3. You can edit the following indexing parameters.

    Parameter Description
    Simplified CGRs

    This creates light representation for terminal leaves. It is very useful to improve performance and reduce memory consumption.

    If you clear this option, build the index, and select it again to rebuild the index. 3D thumbnails will be rebuilt only for the representation created after the last indexing. If you want to create 3D thumbnail for references, you need to start the Thumbnail builder utility.

    2D Thumbnail

    Creates 2D Thumbnails for representations.

    If you clear this option, build the index, and select it again to rebuild the index. 2D Thumbnail will be rebuilt only for the representation created after the last indexing.

    If you want to create 2D thumbnail for references, you need to start the Thumbnail builder utility.

    Activate CGR decimation

    Select this option if you want to reduce the number of triangles in the 3D Thumbnail.

    The value in mm represents the maximum deviation between the simplified CGR and the original CGR that will be allowed for the simplification algorithm. The higher this parameter, the lighter the simplified CGRs (3D Thumbnails), and the further their geometry will be from the original authoring CGR.
    Number of builders

    Choose the number of index builders. The default number is 3.

    The recommended value is 1.5*(number of CPU cores) available on your machine, limited to 16. Adding more builders allow you to get a faster build but also increase the overall memory consumption.

    Maximum number of report directories

    Choose from 1 up to 99 report directories.

  4. To save your changes, select Start > Save.
  5. To close the Index Administration Tool, select Start > Quit.

To Add a New Environment

  1. Start the Index Administration Tool tool using one of the following methods:
    • On Windows, select Start > All Programs > Dassault Systemes 3D Index Server 3DEXPERIENCE R2022x > Tools > 3D Index Environment Administration > 3DIndex Environment Administration.
    • On all platforms, go to the required directory and run the command:

      CATSTART -run "BBDEnvEditor"

    The Index Administration Tool GUI appears.
  2. Select:
    • An existing environment alias, then right-click and select the Add BBDenv command,
    • Or the environment alias, then select the Edit > Add command.

    A dialog box with blank parameters displays.

    Fill in the parameters. For more information, see step 6 in Install 3D Indexing Server to Build Thumbnails and Simplified CGR.

    When you save the environment, it is added to the list of environments. When you want to index your database, you choose the environment to perform the indexing.

  3. To access the preferences, click Tools > Preferences. You can specify another cache location and another BBD Environment file location.
  4. To save your changes, select Start > Save.
  5. To close the Index Administration Tool, select Start > Quit.

To Delete an Existing Environment

  1. Start the Index Administration Tool tool using one of the following methods:
    • On Windows, select Start > All Programs > Dassault Systemes 3D Index Server 3DEXPERIENCE R2022x > Tools > 3D Index Environment Administration > 3DIndex Environment Administration.
    • On all platforms, go to the required directory and run the command:

      CATSTART -run "BBDEnvEditor"

    The Index Administration Tool GUI appears.
  2. To delete an existing environment:
    • select the environment alias, then right-click and select the Delete BBDEnv command, or
    • select the environment alias, then select the Edit > Delete command.

    When prompted to confirm the deletion, click Yes.

  3. To save your changes, select Start > Save.
  4. To close the Index Administration Tool, select Start > Quit.