Changes between Version 9 and Version 10 of doc/app/userint/comp
- Timestamp:
- Apr 6, 2016 3:12:02 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
doc/app/userint/comp
v9 v10 23 23 The files {{{user_***.f90}}} will be automatically compiled within the job and will replace the respective {{{PALM}}}‘s default user-interface routines.\\\\ 24 24 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. \\\\25 The above method with including {{{$fname}}} in the additional source path allows using 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 26 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: 27 27 {{{ … … 30 30 The makefile must be modified appropriately following the "make"-rules in order to allow the new files to be compiled.\\\\ 31 31 '''The modified user-interface files cannot be pre-compiled by using mbuild! '''\\\\ 32 While programming user-defined code, errors are frequently made. For possible ways of error tracing see [../../intdbg Debugging].32 While programming user-defined code, errors are frequently made. For possible ways of error tracing, see [../../intdbg Debugging]. 33 33 34 In case you are calling MPI functions or external functions from your user code, you might get error messages during the namelist file check, which is performed before your job is started. These errors will not occur during your model run, so you might skip the parameter file check in this case. The better option, however, is to exclude these calls from this check. In order to achieve this, can set the preprocessor directive {{{__check}}} where ever needed.34 In case you are calling MPI functions or external functions from your user code, you might get error messages during the namelist file check, which is performed before your job is started. These errors will not occur during your model run, so you might skip the parameter file check in this case. The better option, however, is to exclude these calls from this check. In order to achieve this, can set the preprocessor directive {{{__check}}} wherever needed. 35 35 36 36 '''Example:'''