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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
# Initialize the reproduction pipeline.
#
# Original author:
# Your name <your@email.address>
# Contributing author(s):
# Copyright (C) YYYY, Your Name.
#
# This Makefile is free software: you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation, either version 3 of the License, or (at your
# option) any later version.
#
# This Makefile is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
# Public License for more details.
#
# A copy of the GNU General Public License is available at
# <http://www.gnu.org/licenses/>.
# High-level directory definitions
# --------------------------------
#
# Basic directories that are used throughout the whole pipeline.
#
# Locks are used to make sure that an operation is done in series not in
# parallel (even if Make is run in parallel with the `-j' option). The most
# common case is downloads which are better done in series and not in
# parallel. Also, some programs may not be thread-safe, therefore it will
# be necessary to put a lock on them. This pipeline uses the `flock'
# program to achieve this.
texdir = $(BDIR)/tex
lockdir = $(BDIR)/locks
bdirsym = reproduce/build
mtexdir = $(texdir)/macros
pconfdir = reproduce/config/pipeline
# Make the high-level level directories
# ------------------------------
#
# These are just the top-level directories for all the separate steps. The
# directories (or possible sub-directories) for individual steps will be
# defined and added within their own Makefiles.
$(BDIR):; mkdir $@;
$(mtexdir): | $(texdir); mkdir $@
$(texdir) $(lockdir): | $(BDIR); mkdir $@
# High-level Makefile management
# ------------------------------
#
# About `.PHONY': these are targets that must be built even if a file with
# their name exists. Most don't correspond to a file, but those that do are
# included here ensure that the file is always built in every run: for
# example the pipeline versions may change within two separate runs, so we
# want it to be rebuilt every time.
.PHONY: all clean clean-mmap $(mtexdir)/initialize.tex
clean-mmap:; rm -f reproduce/config/gnuastro/mmap*
clean:
rm -rf $(BDIR) $(bdirsym) *.pdf *.log *.out *.aux *.auxlock \
reproduce/config/gnuastro/mmap*
# Pipeline initialization results
# -------------------------------
#
# This file will store some basic info about the pipeline that is necessary
# for the final PDF. Since these are not version controlled, it must be
# calculated everytime the pipeline is run. So even though this file
# actually exists, it is also aded as a `.PHONY' target above.
$(mtexdir)/initialize.tex: | $(mtexdir)
# Version of the pipeline.
@v=$$(git describe --dirty --always); \
echo "\newcommand{\pipelineversion}{$$v}" > $@
# Version of Gnuastro.
@v=$$(astnoisechisel --version | awk 'NR==1{print $$NF}'); \
echo "\newcommand{\gnuastroversion}{$$v}" >> $@
# Location of the build directory (for LaTeX inputs).
echo "\newcommand{\bdir}{$(BDIR)}" >> $@
# Symbolic link to build directory
# --------------------------------
#
# Besides $(BDIR), we are also making a symbolic link to it if $(bdirsym)
# is not empty. In case this symbolic link is not needed, simply remove its
# value from the definitions above. In that case, it will be read as a
# blank (non-existant).
#
# Note that $(BDIR) might not be an absolute path and this will complicate
# the symbolic link creation. To be generic, we'll first call `readlink' to
# make sure we have an absolute address, then we'll make a symbolic link to
# that.
ifneq ($(bdirsym),)
$(bdirsym): | $(BDIR)
absbdir=$$(readlink -f $(BDIR)); \
ln -s $$absbdir $(bdirsym)
endif
|
