/*
 * Filename : ug.txt.c
 * Contents : It is the user guide of Layout2FastCap.
 * Author   : BARIBRATA BISWAS
 * Date     : 04/30/98
 * Version  : 1.0
 */


1. Makefile :
  ----------

	GNU make is used to build the executable for Layout2FastCap.
The make command is issued from the main directory and it creates
the executable "Layout2FastCap" in the bin directory.

2. Syntax :
  ---------

Following command should be given at the prompt.

%> Layout2FastCap <layer_mapping_file> <process_data_file> < <CIF_file>

The correct syntax can be obtained by just typing the following
at the prompt.

%> Layout2FastCap


3. Input Files :
  --------------

  a. layer_mapping_file : This file contains the mapping of internal
layer names of Layout2FastCap and the layer names used in the CIF file.
An example of this file is in the "setupFiles" directory.

  b. process_data_file : This is used by Layout2FastCap to obtain
the vertical dimension. An example of this file is in the "setupFiles" 
directory.

  c. CIF_file : This is the symbolic representation of layout. In the 
CIF file the the dimensions of the geometric structures should be in 
0.01 microns. Layout2FastCap generates the file for fastcap in microns
which is treated by FastCap as meters. So, the result generated by 
FastCap should be multiplied by 1E-06. For example, if the result of
FastCap is in nanofarads it is actually in femtofarads.


4. Generation of CIF file :
  --------------------------

The conductors in the layout should be labelled before it is changed 
to CIF. The names of the conductors should be unique, i.e., no two 
different conductors should have the same name. Similarly, a given 
conductor should not be labelled twice with two different names.
In this cases Layout2FastCap will flag an error. However, a conductor can
be named twice with same name.

5. Options :
  ---------

Layout2FastCap can be run with various options. These are present in 
the "def.h" file in the src directory. The variables are explained
in the file. But everytime the value is change "make" should be
run to update the executable.

6. Output Files :
  ---------------

Layout2FastCap generates .gen file for each layer and a list file
test.lst for instantiting them. If "image method" is used the list
file needs to be changed using a perl script. The script is 
"modListFile" and is in the bin directory. It should be run in the 
directory where the list file is present (name should be test.lst).
"modListFile" doesn't take any arguments. FastCap is then used with 
the list file to generate the capacitance matrix. (See FastCap 
User Guide).