wscript 10.3 KB
Newer Older
1
2
#!/usr/bin/env python
# encoding: utf-8
3
4
5
6
#| Copyright Inria May 2015
#| This project has received funding from the European Research Council (ERC) under
#| the European Union's Horizon 2020 research and innovation programme (grant
#| agreement No 637972) - see http://www.resibots.eu
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
7
#|
8
9
10
11
12
13
#| Contributor(s):
#|   - Jean-Baptiste Mouret (jean-baptiste.mouret@inria.fr)
#|   - Antoine Cully (antoinecully@gmail.com)
#|   - Kontantinos Chatzilygeroudis (konstantinos.chatzilygeroudis@inria.fr)
#|   - Federico Allocati (fede.allocati@gmail.com)
#|   - Vaios Papaspyros (b.papaspyros@gmail.com)
Konstantinos Chatzilygeroudis's avatar
Konstantinos Chatzilygeroudis committed
14
#|   - Roberto Rama (bertoski@gmail.com)
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
15
#|
16
17
18
19
20
#| This software is a computer library whose purpose is to optimize continuous,
#| black-box functions. It mainly implements Gaussian processes and Bayesian
#| optimization.
#| Main repository: http://github.com/resibots/limbo
#| Documentation: http://www.resibots.eu/limbo
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
21
#|
22
23
24
25
26
#| This software is governed by the CeCILL-C license under French law and
#| abiding by the rules of distribution of free software.  You can  use,
#| modify and/ or redistribute the software under the terms of the CeCILL-C
#| license as circulated by CEA, CNRS and INRIA at the following URL
#| "http://www.cecill.info".
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
27
#|
28
29
30
31
32
#| As a counterpart to the access to the source code and  rights to copy,
#| modify and redistribute granted by the license, users are provided only
#| with a limited warranty  and the software's author,  the holder of the
#| economic rights,  and the successive licensors  have only  limited
#| liability.
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
33
#|
34
35
36
37
38
39
40
41
42
43
#| In this respect, the user's attention is drawn to the risks associated
#| with loading,  using,  modifying and/or developing or reproducing the
#| software by the user in light of its specific status of free software,
#| that may mean  that it is complicated to manipulate,  and  that  also
#| therefore means  that it is reserved for developers  and  experienced
#| professionals having in-depth computer knowledge. Users are therefore
#| encouraged to load and test the software's suitability as regards their
#| requirements in conditions enabling the security of their systems and/or
#| data to be ensured and,  more generally, to use and operate it in the
#| same conditions as regards security.
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
44
#|
45
46
#| The fact that you are presently reading this means that you have had
#| knowledge of the CeCILL-C license and that you accept its terms.
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
47
#|
48
49
import sys
sys.path.insert(0, './waf_tools')
50

51
52
VERSION = '0.0.1'
APPNAME = 'limbo'
53
54
55
56

srcdir = '.'
blddir = 'build'

57
import glob
58
59
import os
import subprocess
60
import limbo, benchmarks
Federico Allocati's avatar
Federico Allocati committed
61
import inspect
62
from waflib import Logs
63
from waflib.Build import BuildContext
64

65
66
67
68
69
def options(opt):
        opt.load('compiler_cxx boost waf_unit_test')
        opt.load('compiler_c')
        opt.load('eigen')
        opt.load('tbb')
70
        opt.load('mkl')
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
71
        opt.load('sferes')
72
        opt.load('limbo')
73
        opt.load('openmp')
74
        opt.load('nlopt')
75
        opt.load('libcmaes')
76
        opt.load('xcode')
77

Vaios Papaspyros's avatar
Vaios Papaspyros committed
78
        opt.add_option('--create', type='string', help='create a new exp', dest='create_exp')
79
        limbo.add_create_options(opt)
80
        opt.add_option('--exp', type='string', help='exp(s) to build, separate by comma', dest='exp')
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
81
82
        opt.add_option('--qsub', type='string', help='config file (json) to submit to torque', dest='qsub')
        opt.add_option('--oar', type='string', help='config file (json) to submit to oar', dest='oar')
83
        opt.add_option('--local', type='string', help='config file (json) to run local', dest='local')
84
        opt.add_option('--local_serial', type='string', help='config file (json) to run local', dest='local_serial')
85
        opt.add_option('--experimental', action='store_true', help='specify to compile the experimental examples', dest='experimental')
86
        opt.add_option('--nb_replicates', type='int', help='number of replicates performed during the benchmark', dest='nb_rep')
87
        opt.add_option('--tests', action='store_true', help='compile tests or not', dest='tests')
88
        opt.add_option('--write_params', type='string', help='write all the default values of parameters in a file (used by the documentation system)', dest='write_params')
89
        opt.add_option('--regression_benchmarks', type='string', help='config file (json) to compile benchmark for regression', dest='regression_benchmarks')
90

91
        for i in glob.glob('exp/*'):
Federico Allocati's avatar
Federico Allocati committed
92
93
                if os.path.isdir(i):
                    opt.recurse(i)
94

95
        opt.recurse('src/benchmarks')
96

97
def configure(conf):
98
        conf.load('compiler_cxx boost waf_unit_test')
99
100
101
        conf.load('compiler_c')
        conf.load('eigen')
        conf.load('tbb')
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
102
        conf.load('sferes')
103
        conf.load('openmp')
104
        conf.load('mkl')
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
105
        conf.load('xcode')
106
        conf.load('nlopt')
107
        conf.load('libcmaes')
108

109
110
        if conf.env.CXX_NAME in ["icc", "icpc"]:
            common_flags = "-Wall -std=c++11"
111
            opt_flags = " -O3 -xHost -mtune=native -unroll -fma -g"
112
        else:
113
            if conf.env.CXX_NAME in ["gcc", "g++"] and int(conf.env['CC_VERSION'][0]+conf.env['CC_VERSION'][1]) < 47:
114
115
116
                common_flags = "-Wall -std=c++0x"
            else:
                common_flags = "-Wall -std=c++11"
117
118
            if conf.env.CXX_NAME in ["clang", "llvm"]:
                common_flags += " -fdiagnostics-color"
119
            opt_flags = " -O3 -g -mavx -mfma -march=native"
120

121
        conf.check_boost(lib='serialization filesystem \
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
122
            system unit_test_framework program_options \
123
            thread', min_version='1.39')
124
125
        conf.check_eigen()
        conf.check_tbb()
126
        conf.check_sferes()
127
128
        conf.check_openmp()
        conf.check_mkl()
129
        conf.check_nlopt()
130
        conf.check_libcmaes()
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
131

Federico Allocati's avatar
Federico Allocati committed
132
133
        conf.env.INCLUDES_LIMBO = os.path.dirname(os.path.abspath(inspect.getfile(inspect.currentframe()))) + "/src"

134
135
        all_flags = common_flags + opt_flags
        conf.env['CXXFLAGS'] = conf.env['CXXFLAGS'] + all_flags.split(' ')
136
        Logs.pprint('NORMAL', 'CXXFLAGS: %s' % conf.env['CXXFLAGS'])
137

Jean-Baptiste Mouret's avatar
misc    
Jean-Baptiste Mouret committed
138
139
        if conf.options.exp:
                for i in conf.options.exp.split(','):
140
                        Logs.pprint('NORMAL', 'configuring for exp: %s' % i)
Jean-Baptiste Mouret's avatar
misc    
Jean-Baptiste Mouret committed
141
                        conf.recurse('exp/' + i)
142
        conf.recurse('src/benchmarks')
143
144
145
146
147
148
149
        Logs.pprint('NORMAL', '')
        Logs.pprint('NORMAL', 'WHAT TO DO NOW?')
        Logs.pprint('NORMAL', '---------------')
        Logs.pprint('NORMAL', '[users] To compile Limbo: ./waf build')
        Logs.pprint('NORMAL', '[users] To compile and run unit tests: ./waf --tests')
        Logs.pprint('NORMAL', '[users] Read the documentation (inc. tutorials) on http://www.resibots.eu/limbo')
        Logs.pprint('NORMAL', '[developers] To compile the HTML documentation (this requires sphinx and the resibots theme): ./waf docs')
150
151
152
153
        Logs.pprint('NORMAL', '[developers] To compile the BO benchmarks: ./waf build_bo_benchmarks')
        Logs.pprint('NORMAL', '[developers] To run the BO benchmarks: ./waf run_bo_benchmarks')
        Logs.pprint('NORMAL', '[developers] To compile the regression benchmarks (requires a json file with the setup): ./waf --regression_benchmarks file.json')
        Logs.pprint('NORMAL', '[developers] To run the regression benchmarks: ./waf run_regression_benchmarks')
154
        Logs.pprint('NORMAL', '[developers] To compile the extensive tests: ./waf build_extensive_tests')
155

Jean-Baptiste Mouret's avatar
misc    
Jean-Baptiste Mouret committed
156

157
def build(bld):
158
159
    if bld.options.write_params:
        limbo.write_default_params(bld.options.write_params)
160
        Logs.pprint('NORMAL', 'default parameters written in %s' % bld.options.write_params)
161
162
163
    bld.recurse('src/')
    if bld.options.exp:
        for i in bld.options.exp.split(','):
164
            Logs.pprint('NORMAL', 'Building exp: %s' % i)
165
            bld.recurse('exp/' + i)
166
            limbo.output_params('exp/'+i)
167
168
    if bld.options.regression_benchmarks:
        limbo.compile_regression_benchmarks(bld, bld.options.regression_benchmarks)
169
    bld.add_post_fun(limbo.summary)
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
170

171
def build_extensive_tests(ctx):
172
    ctx.recurse('src/')
173
174
    ctx.recurse('src/tests')

175
def build_bo_benchmarks(ctx):
176
177
    ctx.recurse('src/benchmarks')

178
179
180
181
def run_extensive_tests(ctx):
    for fullname in glob.glob('build/src/tests/combinations/*'):
        if os.path.isfile(fullname) and os.access(fullname, os.X_OK):
            fpath, fname = os.path.split(fullname)
182
            Logs.pprint('NORMAL', 'Running: %s' % fname)
183
184
            s = "cd " + fpath + "; ./" + fname
            retcode = subprocess.call(s, shell=True, env=None)
185

186
187
188
189
def submit_extensive_tests(ctx):
    for fullname in glob.glob('build/src/tests/combinations/*'):
        if os.path.isfile(fullname) and os.access(fullname, os.X_OK):
            fpath, fname = os.path.split(fullname)
190
            s = "cd " + fpath + ";oarsub -l /nodes=1/core=2,walltime=00:15:00 -n " + fname + " -O " + fname + ".stdout.%jobid%.log -E " + fname + ".stderr.%jobid%.log ./" + fname
191
            retcode = subprocess.call(s, shell=True, env=None)
192
            Logs.pprint('NORMAL', 'oarsub returned: %s' % str(retcode))
193

194
def run_bo_benchmarks(ctx):
195
    benchmarks.run_bo_benchmarks(ctx)
196

197
def run_regression_benchmarks(ctx):
198
    benchmarks.run_regression_benchmarks(ctx)
199

200
def shutdown(ctx):
Vaios Papaspyros's avatar
Vaios Papaspyros committed
201
    if ctx.options.create_exp:
202
        limbo.create_exp(ctx.options.create_exp, ctx.options)
203
204
    if ctx.options.qsub:
        limbo.qsub(ctx.options.qsub)
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
205
206
    if ctx.options.oar:
        limbo.oar(ctx.options.oar)
207
    if ctx.options.local:
208
209
210
        limbo.run_local(ctx.options.local, False)
    if ctx.options.local_serial:
        limbo.run_local(ctx.options.local_serial)
211

212
213
214
def insert_license(ctx):
    limbo.insert_license()

215
def write_default_params(ctx):
216
    Logs.pprint('NORMAL', 'extracting default params to docs/defaults.rst')
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
217
    limbo.write_default_params('docs/defaults.rst')
218

219
def build_docs(ctx):
220
    Logs.pprint('NORMAL', "generating HTML doc with versioning...")
221
    s = 'sphinx-versioning -v build -f docs/pre_script.sh --whitelist-branches "(master|release-*)" docs docs/_build/html'
222
223
    retcode = subprocess.call(s, shell=True, env=None)

224
225
226
class BuildExtensiveTestsContext(BuildContext):
    cmd = 'build_extensive_tests'
    fun = 'build_extensive_tests'
227
228

class BuildBenchmark(BuildContext):
229
230
    cmd = 'build_bo_benchmarks'
    fun = 'build_bo_benchmarks'
231

232
233
234
class InsertLicense(BuildContext):
    cmd = 'insert_license'
    fun = 'insert_license'
Jean-Baptiste Mouret's avatar
Jean-Baptiste Mouret committed
235

236
237
238
class BuildDoc(BuildContext):
    cmd = 'docs'
    fun = 'build_docs'
239
240
241

class BuildDoc(BuildContext):
    cmd = 'default_params'
242
    fun = 'write_default_params'