The Area Fill Manager program is controlled from a command line. The syntax is defined below:

areafillmgr64  inputfile outputfile structure operation(s) [options]

where

areafillmgr64  path and executable of the manager program

inputfile      input GDSII stream file or OASIS. The detection of file type
               is automatic and need not be specified as an argument. 

outputfile     output file (ascii)

structure      structure to process. Use = if you want the areafill
               program to automatically find the top level structure.

operations(s)  describe boolean combination of layers.


 +             is a shorthand to process all layers present in the file 
               individually

 +1,2,5        indicates that 2 and 5 are to be treated as if 
               equivalent to 1, i.e. layers 1, 2 and 5
               are unionized together when computing areas

 +1,2;+5       indicates two different jobs; in the first job 
               layers 1 and 2 are treated equivalently and only 
               layer 5 is considered in the second job

 +1,2-5        directs that layer 5 is subtracted from the union 
               of layers 1 and 2

 -1,2          directs the reversal of the union of layers 1 and 2


[options]

-window:xmin,ymin,xmax,ymax         process only the data contained within 
                                    the window (xmin,ymin,xmax,ymax)

-nclip:nx,ny                        manual partitioning of the database.

 +nclip:1,1                         automatic partioning of the database.

-tile:Dx,Dy                         to compute areas for tiles of dimension 
                                    Dx by Dy. Overrides the nclip settings.


-details                            do detail logging


-notvalidate[:N]                    do not validate the input stream.
                                    N=2 input is convex in both X and Y
                                    N=1 input is convex in X


-perimeter[:P]                      do perimeter calculation
                                    -perimeter:x|y   
                                    -perimeter:x+y


-falseperimeter                     do not add false edges to perimeter
                                    calculation.


-xml                                format the output text file in XML.  
                                    Not available for perimeter data.


-lscan                              scan the file and report the top level
                                    structure name along with a list of
                                    layers containing data. Does not compute
                                    area density.

-step:N                             super sample during explosion by factor N
                                    use when the layer contains large/long
                                    entities that span multiple tiles.

-nfork:N                            The number of processes that should be
                                    spawned by the areafill manager.

-thrnum:M                           The number of threads per process that
                                    can be used.
                                    
                                    Note: the number of licenses available
                                    must be NxM. If nfork and thrnum are
                                    not specified, the areafillmgr will
                                    select values based on the number of
                                    available CPUs and licenses.

Examples

The command lines shown below have breaks added for clarity and annotation. Do not use such line breaks when creating the command line.

In the first example, we want to get the total area of the data on layer 1.

../bin/areafill32            executable        

    ./100umBoxArray.gds      input file

      ./total_area.txt       output file

        =                    use top structure

         +1                  process layer 1

           +nclip:1,1        automatically partion databse

In the second example, we wish to generate a table that shows the area in 100 x 100 um windows.

../bin/areafill32            executable        

    ./100umBoxArray.gds      input file

      ./100umwindows.txt     output file

        =                    use top structure

         +1                  process layer 1

           -tile:100,100     divide into 100x100 um tiles