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

areafill32 inputfile outputfile structure operation(s) [options]

where

areafill32     path and executable 

inputfile      input GDSII stream file

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 
           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         to process only the data
                                    confined 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. This
                                    option 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.

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