Changes between Version 1 and Version 2 of doc/app/userint/comp
- Timestamp:
- Sep 15, 2010 12:19:19 PM (14 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
doc/app/userint/comp
v1 v2 1 1 == Compiling and linking user-defined code == 2 2 3 Users can add their own (modified) user-interface to a PALM-run by carrying out the following steps: 4 3 Users can add their own (modified) user-interface to a PALM-run by carrying out the following steps:\\\\ 5 4 1. Copy the appropriate default (empty) user-interface files {{{user_***.f90}}} to a directory of your choice, e.g.: 6 5 {{{ … … 9 8 cp trunk/SOURCE/user_***.f90 USER_CODE/example 10 9 }}} 11 Attention: do not change the filenames!10 '''Attention: do not change the filenames!''' 12 11 13 12 2. Set an additional path in the configuration file .mrun.config to allow mrun to find and include these files: … … 15 14 %add_source_path $base_directory/USER_CODE/$fname 16 15 }}} 17 The default configuration file ({{{trunk/SCRIPTS/.mrun.config.default}}}) already includes this setting. 18 3. Modify the interface routines according to your needs. 16 The default configuration file ({{{trunk/SCRIPTS/.mrun.config.default}}}) already includes this setting.\\ 17 3. Modify the interface routines according to your needs.\\ 19 18 4. Start a PALM run by executing 20 19 {{{ 21 20 mrun -d example ... 22 21 }}} 23 The files {{{user_***.f90}}} will be automatically compiled within the job and will replace the respective {{{PALM}}}‘s default user-interface routines. 22 The files {{{user_***.f90}}} will be automatically compiled within the job and will replace the respective {{{PALM}}}‘s default user-interface routines.\\\\ 24 23 25 The above method with including {{{$fname}}} in the additional source path allows to use different user-interfaces for different runs at the same time. Just store the respective interface-files in subdirectories {{{USER_CODE/abcd}}}, {{{USER_CODE/cdef}}}, etc. and start '''mrun''' with option "{{{-d abcd}}}", "{{{-d cdef}}}", etc. 26 24 The above method with including {{{$fname}}} in the additional source path allows to use different user-interfaces for different runs at the same time. Just store the respective interface-files in subdirectories {{{USER_CODE/abcd}}}, {{{USER_CODE/cdef}}}, etc. and start '''mrun''' with option "{{{-d abcd}}}", "{{{-d cdef}}}", etc. \\\\ 27 25 If the user wants to add additional routines, he/she can a) put them into the default user-interface file {{{user_additional_routines.f90}}} or b) can create new files in the additional source directory. These files must have names different from the default {{{PALM}}} source code files. In case of b), the user must also copy the default makefile into the additional source directory: 28 26 {{{