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
|
.. _ref-to-command-line-features:
Command line features
=====================
.. meta::
:description: DataLab command line features
:keywords: command line, datalab, run, test, demo
Run DataLab
-----------
To run DataLab from the command line, type the following::
$ datalab
To show help on command line usage, simply run::
$ datalab --help
usage: app.py [-h] [-b path] [-v] [--unattended] [--screenshot] [--delay DELAY] [--xmlrpcport PORT]
[--verbose {quiet,minimal,normal}]
[h5]
Run DataLab
positional arguments:
h5 HDF5 file names (separated by ';'), optionally with dataset name (separated by ',')
options:
-h, --help show this help message and exit
-b path, --h5browser path
path to open with HDF5 browser
-v, --version show DataLab version
--reset reset DataLab configuration
--unattended non-interactive mode
--accept_dialogs accept dialogs in unattended mode
--screenshot automatic screenshots
--delay DELAY delay (ms) before quitting application in unattended mode
--xmlrpcport XMLRPCPORT
XML-RPC port number
--verbose {quiet,normal,debug}
verbosity level: for debugging/testing purpose
Open HDF5 file at startup
-------------------------
To open HDF5 files, or even import only a specified HDF5 dataset, use the following::
$ datalab /path/to/file1.h5
$ datalab /path/to/file1.h5,/path/to/dataset1
$ datalab /path/to/file1.h5,/path/to/dataset1;/path/to/file2.h5,/path/to/dataset2
Open HDF5 browser at startup
----------------------------
To open the HDF5 browser at startup, use one of the following commands::
$ datalab -b /path/to/file1.h5
$ datalab --h5browser /path/to/file1.h5
Run DataLab demo
----------------
To execute DataLab demo, run the following::
$ datalab-demo
.. _run_scientific_validation_tests:
Run technical validation tests
-------------------------------
.. note:: Technical validation tests are directly included in individual unit tests
and are disseminated throughout the code. The test functions including validation
tests are marked with the ``@pytest.mark.validation`` decorator.
To execute DataLab technical validation tests, run the following::
$ pytest -m validation
.. seealso:: See section :ref:`validation` for more information on DataLab's validation strategy.
.. _run_functional_validation_tests:
Run complete test suite
------------------------
To execute all DataLab unit tests, simply run::
$ pytest
Run interactive tests
---------------------
To execute DataLab interactive tests, run the following::
$ datalab-tests
.. image:: /images/interactive_tests.png
|
