View source for Linux Instructions

KRC Build Instructions for Linux (and Mac) System
Last updated: 31 July 2018; KRC version 3.5.6


Notes:  These build instructions are the steps that Robin Fergason, Sylvain Piqueux, and Christopher Edwards perform to compile new versions of KRC.  Robin works in a Bash environment, and has no issues with the below instructions.  

There are more detailed build instructions included in the KRC distribution in aaa/AAinstall. 
The below instructions do not build the IDL scripts. 
If you are interested in access the IDL scripts that accompany KRC, then please see the build instructions provided in the KRC distribution.
	

'''Step 1: Create a build directory and untar the KRC distribution'''
•	Create a clean (new) directory (e.g. “mkdir KRC_356” for KRC Version 3.5.6)

•	Copy or move the KRC distribution file into the new directory

•	Untar the distribution file (tar –xvf or tar –xzf). This action should create five sub-directories: aaa, doc, idl, run and src

•	Older distribution files might have two tar files, one of which will contain the "big" directory. In this case, untarring the distribution will create six directories. 3.2.1 onward the distribution hasn’t had the "big" directory)



'''Step 2: Compile all programs associated with the KRC build''' 

•	Cd into the src/cfiles directory to make it the current working directory (cd src/cfiles/). Type the following command to compile the C programs in that directory.
 make all

•	Cd back into src to make it the current working directory (cd ../src). Type the following commands to build krc and porbmn, which use the specifications in the Makefile located in that same directory.
 make krc
 make porbmn

•	If desired, cd into run to make it the current working directory (cd ../../run) and create a couple of soft links for the KRC executable. 
Alternatively, you can simply copy the KRC executable that you created in the src directory to where every you will be working.
 ln –s ../src/krc
 ln –s ../src/porbmn
Caution: Sometimes krc will have a slightly different name. If errors result, look in the Makefile in the src directory to check the appropriate name.


'''Step 3: Test the newly built KRC'''
•	Execute krc (./krc) and test that the compiled version of KRC works on your system

•	The run directory has example input files which will help verify that krc has been installed correctly. Type in an appropriate name for the output file. This output file will be created in the “run” directory with ‘.prt’ extension