|
|
## Folder structure
|
|
|
|
|
|
- The kernelname contains only letters, numbers and dividing-characters
|
|
|
- The kernelname consists of 6 elements (categories) in the following order
|
|
|
1. Top category name (e.g. "grafical", "IO", "numerical")
|
|
|
2. Name of the algorithm (application, part of an application an so on... e.g. "matmul", "vecadd", "latencies")
|
|
|
3. Programming Language (e.g. "C", "Java" or "F77")
|
|
|
4. parallelisation library/libraries (multiple chunks possible, e.g. "MPI", "pThreads")
|
|
|
5. other library/libraies (multiple chunks possible)
|
|
|
6. (data) type (e.g. "double", "float")
|
|
|
7. a comment (only for naming the binary!)
|
|
|
- "." and "-" are the only accepted dividing characters. Behaviour for using other characters is unpredictable. "."'s divide the categories. "--"'s divide multiple chunks of one category (e.g. "MPI-OpenMP"). These chunks should be ordered alphabetically to prevent multiple names for one and the same kernel. Both, "." AND "-" aren't allowed in category-names! Also, the first character after a "." has to be a letter or "0"!
|
|
|
- If there is no entry for a category (e.g. the kernel is sequential, so there's no parallel library), the category is named "0".
|
|
|
- The categories 1 to 6 are mapped hierarchically in the kernel-directory "${BENCHITROOT}/kernel". Every category accords to a sub folder. The category 7 is added to the binary name by using the BENCHIT_FILENAME_COMMENT or interpreting the ${BENCHITROOT}/COMPILE.SH-flag --comment/-c from the compile-time to allow different compilations of one and the same kernel.
|
|
|
- The name of a binary matches the categories 1 to 7, divided by "."'s. The binaries are located in the folder "${BENCHITROOT}/bin". Compiled Java kernels are saved into a folder with the according name.
|
|
|
- The structure of the output directory matches 1:1 to the kernel directory.
|
|
|
- A result-file consists of 3 elements
|
|
|
1. architecture information (according to BENCHIT_ARCH_SHORT and BENCHIT_ARCH_SPEED, e.g. InP3_700M)
|
|
|
2. the comment according to 1.g)
|
|
|
3. date and time of run.
|
|
|
these categories are divided by "__"'s, elements within these categories are divided by "_"'s.
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
- The files of kernel "numerical.matmul.C.0.0.double"
|
|
|
- are placed in directory "${BENCHITROOT}/kernel/numerical/matmul/C/0/0/double".
|
|
|
- Compiled with BENCHIT_FILENAME_COMMENT=v01 esults in binary: "${BENCHITROOT}/bin/numerical.matmul.C.0.0.double.v01".
|
|
|
- The result file is placed in: "${BENCHITROOT}/output/numerical/matmul/C/0/0/double/"
|
|
|
with the name "InP3_700M__v01__2005_07_14__13_51_59.bit" (depends on time)
|
|
|
|
|
|
- The files of kernel "numerical.matmul.F77.MPI--pThreads.BLAS3.double"
|
|
|
- are placed in folder "${BENCHITROOT}/kernel/numerical/matmul/F77/MPI--pThreads/BLAS3/double".
|
|
|
- The resulting binary may be: "${BENCHITROOT}/bin/numerical.matmul.F77.MPI--pThreads.BLAS3.double.DTRMM-v02".
|
|
|
- The result file is placed in the folder "${BENCHITROOT}/output/numerical/matmul/F77/MPI--pThreads/BLAS3/double" and is named "InP3_700M__DTRMM_v02__2005_07_14__13_51_59.bit"
|
|
|
|
|
|
- The files of kernel "numerical.matmul.Java.0.0.double"
|
|
|
- are placed in folder "${BENCHITROOT}/kernel/numerical/matmul/Java/0/0/double".
|
|
|
- The resulting executable file: "${BENCHITROOT}/bin/numerical.matmul.Java.0.0.double.v03/RUN.SH".
|
|
|
- The result file is placed in folder "${BENCHITROOT}/output/numerical/matmul/Java/0/0/double"
|
|
|
and named "InP3_700M__v03__2005_07_14__13_51_59.bit"
|
|
|
|
|
|
\ No newline at end of file |