Skip to documentation
BRL-CAD
DocumentationAll documentsEnglish

TOPS(nged)

NAME

tops - Displays a list of all the _top-level_ objects in the current database.

On this page

SYNOPSIS

tops [-a] [-h] [-n] [-p]

DESCRIPTION

Displays the top-level objects in the current database. Top-level objects are objects not referenced by any other combination. In most BRL-CAD databases, this usually includes one or more assembly objects near the root of the model hierarchy.

By default, tops lists only non-hidden top-level database objects. The output is sorted alphabetically and formatted in columns. Combination names are decorated with a trailing /, and region names are decorated with a trailing R; region combinations therefore typically appear with /R.

The following options are supported:

  • -a - List all top-level objects, including hidden objects and phony directory entries.

  • -h - List only hidden top-level objects.

  • -n - Suppress the default / and R output decorations.

  • -p - List only phony top-level directory entries.

The -h and -p filters may be combined to include both hidden and phony top-level entries. If -a is specified, it overrides those filters and reports all top-level entries.

EXAMPLES

These examples show the use of the tops command to list top-level objects in the current database.

Example 1. List all the top-level objects in the current database.

mged>tops

Lists non-hidden top-level database objects. Combination and region entries are decorated in the output.

Example 2. List all top-level objects, including hidden and phony entries.

mged>tops -a

Lists all top-level objects, including hidden objects and phony directory entries.

Example 3. List only hidden top-level objects.

mged>tops -h

Lists only top-level objects that have been marked hidden.

Example 4. List only phony top-level directory entries.

mged>tops -p

Lists only top-level phony directory entries.

Example 5. List top-level object names without combination or region suffixes.

mged>tops -n

Lists top-level objects without the default / and R decorations.

AUTHOR

BRL-CAD Team

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org