
	     		-- Install Manual --
		    Parallel Cell Placement Experimental System 

How to install :
	
	     1) Make work directory and sub-directories and copy source files
	     2) Catalogue ESP files and Compile KL1 files
	     3) Setup initialize file


     1) Make work directory and sub-directories and copy source files.

     1-1) Prepare working directory
        Register a new user, and use new user's home directory as
	working directory.
	If you regist new user with user name "placement",
	home directory will be created just below the ">sys>user>"
	directory.
	    		****** How to regist new user ******
	1) Login SIMPOS as superuser.
	   (username : superuser, password : superuser)
	2) Select "others" command from system menu
	3) Select "user" command
	4) Select "maintenance" command
	5) Select "register" command
	6) Type "placement" as username, and any sequence of string
	   as password.
	   Rank must be "super_U"
	7) Select "modify" command
	8) Change Initial mode(New) to "super"
	9) Now the user registoration have completed, and 
	   home directory ">sys>user>placement" has been created
		We regard this home directory as "working directory" afterward.
	    1-2) Prepare working sub-directories
		Make following sub-directories just below the "working
		directory".
		ESP	: directory of ESP source
		KL1	: directory of KL1 source
		VPNR	: directory of VPNR format data
		Copy folowing files to each directory.
		Font files must be copied just below the "working directory.
		Initialize files to just below the login home directory;
		i.e,  below "me:" directory.


		****** directories and files ******

	ESP $B!'(B
		DRIVERs.esp	: driver to execute program without KL1
		annealing.esp	: annealing procedure
		as_place.esp	: detail placement information
		g_mani.esp	: graph manipulator
		g_read.esp	: graph menu reader
		handler.esp	: save or load placement data
		init_para.esp	: initialize parameters
		init_place.esp	: initialize placement
		main.esp	: main routine for I/O between KL1
		manipulator.esp	: cell manipulator
		parser.esp	: ceate and manipulate database
		std_log.esp	: gather annealing log
		vpnr_parser.esp	: parse VPNR format data
		windows.esp	: customized windows

	KL1 $B!'(B
		top.kl1		: interface between ESP and KL1
		main.kl1	: fork managers and throw annealing processes
		annealing.kl1	: main routine for annealing procedure
		an_module.kl1	: detail routine for annealing procedure
		init.kl1	: initialize and manipulate database
		util.kl1	: some handy utilities
		overlap.kl1	: remove overlap between modules
		rn.kl1		: generate pseudo random numbers

	VPNR $B!'(B
		GRID36io.vpnr	: 36 cells,#84 nets(artificial data)
		fract.vpnr	: 125 cells,#149 nets
		db100.vpnr	: library for fract
		primary1.vpnr	: 752 cells, #904 nets
		sclib100.vpnr	: library for primary1

	FONT $B!'(B
		arrow.font      : Font file for arrow menu
		title.font	: Font file for title
		GRID36io.font	: Font file for GRID36io.vpnr

	INITIALIZE FILE $B!'(B
		std_cell.init   : Initialize file
		GRID36io.param	: Initialize file for GRID36io
		s109.param 	: Initialize file for fract

     2) Catalogue ESP files and Compile KL1 files

     2-1) Catalogue ESP source files --

	Create "librarian" process, and define new package "placement".
	Catalogue all ESP source files under "placement" package.
	And also save all classes after catalogue has completed.

		****** How to catalogue and save ******

		1) Call "librarian" from system menu
		2) Select "Package" commnad.
		3) Select "Define package" command.
		4) Type "placement" for Package name.
		5) Select "Yes" item to execute creation.
		6) Confirm environment as "simpos", select "do it" item.
		7) Select "Package" command.
		8) Select "Set default package" command.
		9) Type "placement" as default package.
		10) Select "do it" item.
		11) Select "Catalogue" command.
		12) Type ">sys>user>placement>ESP>*.esp" for filenames
		13) Select "do it" item.
		14) Select "Save" command after "Catalogue" command
		    has beeen completed.
		15) Confirm that all catalogue classes are selected and
		    select "do it" command.

     2-2) compile KL1 source files --

	(Set package name to "placement"  from pimos shell.)
	Compile all KL1 source.
	Unload all modules after compile has been completed.

		***** How to compile and unload ******

		1) Login on "PIMOS" (See PIMOS manual)
		2) Execute 'cd ">sys>user>placement>KL1" ' command.
		2) Execute 'compile(["top","main","an1mat1","an_module1",
			    "init","util","overlap","rn"]) command.
		4) Execute	unload([placement,main,annealing,an,
				initialize,my_util,remove_overlap,rn0],
						"plc.sav")
		   after compile has been completed.
		   From next login, you can load saved file by 
		   executing 'load("plc.sav") ' command.

     3) Setup initialize file

     3-1) How initialize file will be selected --

	  Initialize file will be read due to the following rules.

	1)At first, search for "std_cell.init" file under 
	  ">sys>user>placement" directory or "me:" directory.

	2)If the file exists, read it. ( goto 3) )
	  Otherwise, system set each parameter value to arbitrary value

	3)If "if_data_directory" parameter is defined in the init file,
	  system search for the special parameter file just below the
	  defined directory. (goto 4) )
	  Otherwise, system set each parameter due to "std_cell.init"
	  file.

	 4)If the special parameter file; which name is constructed
           from domain name of the vpnr data that is followed by 
	   ".param" extension; exsits, read it.
	  Otherwise, system set each parameter due to "std_cell.init"
		  file.

     3-2) Representative initial parameters to setup --

	  We explain about some representative initial parameters.

		if_data_directory : Directory for parsed data files
		data_search_path  : Directory for circuit data
		default_data_path : Default file name for circuit data
		arrow_font        : Font file for graph manipulator
		title_font        : Font file for label.
		domain_param_directory : 
			    This parameter is valid only in
			    "std_cell.init" file.
			    If this parameter is given, system search
			    for the file; which name is constructed
	                    from domain name of the vpnr data that is
			    followed by  ".param" extension.
			    If this file exsits, read it.

		state19		  : must be "on". 

	* Some other parameters are not described here.
