Name

stat — report information about objects in a BRL-CAD database

Synopsis

stat [-h] [-?] [-r] [-F string] [-C type1[,type2]...] [-S type1[,type2]...] {glob pattern}

Overview

The GED stat command reports information about objects in a BRL-CAD .g file. It produces a tabular output, with options for user configurability and sorting.

Available types reflect geometry object data:

Table 1. STAT Information Keys - Core Object Info

nameObject database name (for example, "primitive.s")
usesNumber of uses, from instancing
sizeSize of database object
refsNumber of times object is referenced by COMBs
flagsFlags
major_typeObject major type
minor_typeObject minor type
typeObject type (short name)



In addition to the above standard keys, attributes may also be specified. If the desired attribute happens to have the same name as one of the above standard keys, the prefix "attr:" may be added to denote an attribute.

OPTIONS

-h or -?

Print help and exit.

-r

Print raw values, instead of human friendly strings (for example, 5195952 for a size instead of 5.0M).

-F

Specify search style filters to trim down what is reported in stat output.

-C

Supply a comma separated list of column specifiers or attribute keys to define the table layout for stat.

-S

Supply a comma separated list of column specifiers or attribute keys to specify a sorting priority for stat. Priority is left to right - sorting will be performed first based on the leftmost specifier, and subsequent specifiers will be used to resolve any ties. To revers the ordering decisions for a given column, prefix the specifier with a "!" character.

EXAMPLES

Example 1. Default Output

stat *



 Object Name             uses   References   Flags   Type     Size 

----------------------- ------ ------------ ------- -------- ------

 Default                 0      1            2       comb     288B 

 NIST_MBE_PMI_7-10.3dm   0      0            2       comb     264B 

 Solid1.r                0      1            6       region   280B 

 Solid1.r.s              0      1            1       brep     859K 

 Solid1_2.r              0      1            6       region   280B 

 Solid1_2.r.s            0      1            1       brep     672K 

 Solid1_3.r              0      1            6       region   280B 

 Solid1_3.r.s            0      1            1       brep     431K 

 Solid1_4.r              0      1            6       region   280B 

 Solid1_4.r.s            0      1            1       brep     771K 

 _GLOBAL                 0      0            8                96B 

      



Example 2. Sorting by Size

stat -S "size" *



 Object Name             uses   References   Flags   Type     Size 

----------------------- ------ ------------ ------- -------- ------

 _GLOBAL                 0      0            8                96B  

 NIST_MBE_PMI_7-10.3dm   0      0            2       comb     264B 

 Solid1_2.r              0      1            6       region   280B 

 Solid1_3.r              0      1            6       region   280B 

 Solid1.r                0      1            6       region   280B 

 Solid1_4.r              0      1            6       region   280B 

 Default                 0      1            2       comb     288B 

 Solid1_3.r.s            0      1            1       brep     431K 

 Solid1_2.r.s            0      1            1       brep     672K 

 Solid1_4.r.s            0      1            1       brep     771K 

 Solid1.r.s              0      1            1       brep     859K 

      



Example 3. Sorting by Size, Reversed Order

stat -S "!size" *



 Object Name             uses   References   Flags   Type     Size 

----------------------- ------ ------------ ------- -------- ------

 Solid1.r.s              0      1            1       brep     859K 

 Solid1_4.r.s            0      1            1       brep     771K 

 Solid1_2.r.s            0      1            1       brep     672K 

 Solid1_3.r.s            0      1            1       brep     431K 

 Default                 0      1            2       comb     288B 

 Solid1_3.r              0      1            6       region   280B 

 Solid1.r                0      1            6       region   280B 

 Solid1_2.r              0      1            6       region   280B 

 Solid1_4.r              0      1            6       region   280B 

 NIST_MBE_PMI_7-10.3dm   0      0            2       comb     264B 

 _GLOBAL                 0      0            8                96B 

      



Example 4. Filtering by Type

stat -F "-type brep" *



 Object Name    uses   References   Flags   Type   Size 

-------------- ------ ------------ ------- ------ ------

 Solid1.r.s     0      1            1       brep   859K 

 Solid1_2.r.s   0      1            1       brep   672K 

 Solid1_3.r.s   0      1            1       brep   431K 

 Solid1_4.r.s   0      1            1       brep   771K

      



Example 5. Custom Columns

stat -C "name,type,size,color" *



 Object Name             Type     Size   color       

----------------------- -------- ------ -------------

 Default                 comb     288B   0/0/0       

 NIST_MBE_PMI_7-10.3dm   comb     264B   0/0/0       

 Solid1.r                region   280B   153/231/254 

 Solid1.r.s              brep     859K               

 Solid1_2.r              region   280B   255/206/142 

 Solid1_2.r.s            brep     672K               

 Solid1_3.r              region   280B   237/255/168 

 Solid1_3.r.s            brep     431K               

 Solid1_4.r              region   280B   178/178/178 

 Solid1_4.r.s            brep     771K               

 _GLOBAL                          96B