1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
# Top-level user specific directories. Note the points below:
#
# - The VALUES to these directories are initially JUST PLACE-HOLDERS!
# Please correct them based on your system.
#
# - The directories don't need to necessarily exist. If they do not exist,
# they will be created and the necessary data will be downloaded into
# them. Ofcourse provided that you have write permissions and an internet
# connection.
#
# - Do not use the tilde expansion `~' or variables for your home
# directory. Please use the full address, for example
# `/home/your-user-name'.
#
# - An ending forward-slash `/' is NOT necessary. In the pipeline, all
# these variables will be followed by a `/', so if you put a `/' at the
# end of the value here, you will see a `//' in the printed outputs
# during the processing. This has no technical problem, but can make
# reading the outputs harder and is thus not recommended.
# Build directory
# ---------------
#
# This is where the intermediate outputs of each step are kept.
#
# Why a separate build directory? So the source and configuration files for
# this reproduction pipeline do not get crowded by all the
# intermediate/derivative files. Also to make synchronization and backups
# more easy: the contents of the build directory do not need to be backed
# up since they can be reproduced and they can be large.
#
# IMPORTANT NOTE: Keep atleast one blank space before and after `='.
BDIR = /path/of/directory/for/building
# (OPTIONAL) Dependencies directory
# ---------------------------------
#
# To ensure an identical build environment, the pipeline will use its own
# build of the programs it needs. Therefore the tarball of the relevant
# programs are necessary for this pipeline. If a tarball isn't present in
# the specified directory, it will be downloaded by the pipeline. Therefore
# an internet connection will be mandatory.
#
# Important note: Keep atleast one blank space before and after `='.
DEPENDENCIES-DIR = /optional/path/to/directory/containing/tarballs
# (OPTIONAL) Memory mapping minimum size
# --------------------------------------
#
# Some programs (for example Gnuastro) can deal with cases where the local
# system doesn't have enough memory (RAM) to keep large files there. For
# example, they will create memory-mapped (`mmap' for short) files on the
# HDD or SSD and read/write to them instead of RAM. This will ofcourse,
# slow down the processing, but atleast the program won't crash.
#
# Since the memory requirements of different systems are different and it
# has no effect on the software's final result, the minimum size of an
# allocated array to warrant a mapping to HDD/SSD instead of RAM must also
# be defined here. This value will be used in the programs that support
# this feature.
MINMAPSIZE = 1000000000
# (OPTIONAL) Downloader program
# -----------------------------
#
# The downloder program (and its output option name, for example `wget -O'
# or `curl -o') that will be used if any of the necessary datasets aren't
# already available on the system.
#
# This is usually set at an early stage of the configuration system
# automatically before the file is opened for editing by the user. It is
# thus recommended to not modify it manually.
DOWNLOADER = @downloader@
|