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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
|
================================================================================
____ ____ _ _ ____ _____ ____
| _ \| _ \| | | / ___|| ____| _ \
| | | | |_) | | | \___ \| _| | |_) |
| |_| | __/| |_| |___) | |___| _ <
|____/|_| \___/|____/|_____|_| \_\
_
_| |_
|_ _|
|_|
___ _____ _ _ __ ___
/ _ \| ___(_) |_ __\ \ / (_) _____ __
| | | | |_ | | __/ __\ \ / /| |/ _ \ \ /\ / /
| |_| | _| | | |_\__ \\ V / | | __/\ V V /
\__\_\_| |_|\__|___/ \_/ |_|\___| \_/\_/
================================================================================
DPUSER is a command line program which provides an interactive language that is
capable of handling numbers (both real and complex), strings, and matrices. Its
main aim is to do astronomical image analysis, for which it provides a compre-
hensive set of functions, but it can also be used for many other applications.
For help on dpuser see http://www.mpe.mpg.de/~ott/dpuser/index.html
QFitsView is a FITS file viewer based on DPUSER. In addition to displaying
two-dimensional images, it also provides means to explore three-dimensional
data cubes. It integrates the functionality of DPUSER which can be accessed di-
rectly out of QFitsView.
================================================================================
Contents
================================================================================
1) Supported operating systems
2) Project structure
3) Compiling
3.1) Linux & MacOS
3.1.1) Needed libraries
3.1.2) Compiling DPUSER
3.1.3) Compiling QFitsView
3.2) Windows
3.2.1) Installing needed libraries
3.2.2) MinGW
3.2.2.1) Compiling DPUSER
3.2.2.2) Compiling QFitsView
3.2.3) Visual C++ 2008 Express Edition
3.2.3.1) Compiling DPUSER
3.2.3.2) Compiling QFitsView
3.2.4) CYGWIN
3.2.4.1) Compiling DPUSER
4) DPUSER Documentation
5) Create a distribution
6) Using ds9 together with DPUSER
7) Functionality/Problem table
8) make-targets
9) compiling using cmake
================================================================================
1) Supported operating systems
================================================================================
DPUSER and QFitsView can be used with following operating systems:
- Linux (Kubuntu 12.04 Precise Pangolin)
- MacOS X (Intel only) (MacOS X 10.6.8)
- Win32 (Windows 7)
Each both in 32bit and 64bit
================================================================================
2) Project structure
================================================================================
A short description of the contents of the directories is given:
- QFitsView The QFitsView source code.
- bin Utilities needed to build DPUSER correctly.
- dpuser The DPUSER source code.
- external Source code of needed external libraries.
- include Needed include-files.
- lib Needed libraries, in different versions for the different
supported operating systems.
- libfits A collection of functions for astronomical and mathematical cal-
culations. Furthermore the fits-class is defined here, with nu-
merous functions performing any kind of calculations on FITS
images.
- QFitsView The QFitsView source code.
- utils Various utilities like regular expressions, string class etc.
================================================================================
3) Compiling
================================================================================
ATTENTION:
The files dpuser.y and dpuser.l in dpuser/parser should be edited ONLY UNDER
WINDOWS! Compilation will not fail if edited under Linux, but at runtime
DPUSER will not work correctly! (If they are compiled under Linux, there will
be anyway a compile error when compiling DPUSER). Or use the todos-command to
convert whitespaces from Linux format to DOS format.
In order to compile QFitsView the Qt-library has to be compiled first. The
sources are located in dpuser/external, read the README in this folder for
instructions. The version of the provided Qt distribution is guaranteed to work
together with the QFitsView source code.
All other libraries in dpuser/external are already precompiled for a variety of
operating systems.
NOTE: Qt and VTK
The vtk-library used by QFitsView is compiled with Qt-GUI-support. So the Qt-
version used for compiling QFitsView must be the same as the one used to
compile the VTK-library!
NOTE:
If configuring Qt doesn't recognise OpenGL try adding following lines to
qt-everywhere-opensource-src-5.1.1/qtbase/mkspecs/linux-g++/qmake.conf:
QMAKE_INCDIR_OPENGL = /usr/include/GL
QMAKE_LIBDIR_OPENGL = /usr/lib/x86_64-linux-gnu
QMAKE_LIBS_OPENGL = -lGL
================================================================================
3.1) Linux & MacOS
================================================================================
ATTENTION:
Under Linux following packages must be installed:
libx11-dev
libxt-dev
libglu1-mesa-dev
libxext-dev
xfonts-scalable
Under MacOS following command has to be executed before compiling:
$ ranlib lib/*.a
================================================================================
3.1.1) Needed libraries
================================================================================
- When compiling DPUSER or QFitsView fails, check if any of the following
libraries are missing:
- libx11-dev
- libgl1-mesa-dev
- libglu1-mesa-dev
- libxext6
- libext-dev
- zlib1g-dev
- libx11-xcb-dev
- libxrender-dev
- libtiff4
- libtiff4-dev
- libmng1
- libmng-dev
================================================================================
3.1.2) Compiling DPUSER
================================================================================
Change into the "dpuser" directory and execute following command:
$ make
For a debug version type:
$ make debug
================================================================================
3.1.3) Compiling QFitsView
================================================================================
Change into the "QFitsView" directory and execute following command:
Linux & Mac (with Intel-processor) (release):
$ make
Linux & Mac (with Intel-processor) (debug):
$ make debug
================================================================================
3.2) Windows
================================================================================
3.2.1) Installing needed libraries
================================================================================
- To compile QFitsView Qt 5.2.0 or newer must be installed. Qt must be compiled
with the desired compiler suite.
- DPUSER and QFitsView are principally compiled statically so a single binary
is produced and can be distributed easily. This works well under Linux and
MacOS.Unfortunaltely with Windows this approach is only feasible with some
drawbacks. These are listed in Section 7. According this table Qt can either be
compiled statically or dynamically.
- TortoiseSVN has to be installed with command line tools installed as well (svnversion.exe)
MinGW (static):
---------------
$ configure.exe -fast -release -static -qt-zlib -qt-libmng -qt-libtiff
-qt-gif -qt-libpng -qt-libjpeg -platform win32-g++
$ configure.exe -fast -debug -static -qt-zlib -qt-libmng -qt-libtiff
-qt-gif -qt-libpng -qt-libjpeg -platform win32-g++
MinGW (shared):
---------------
$ configure.exe -fast -release -shared -qt-zlib -qt-libmng -qt-libtiff
-qt-gif -qt-libpng -qt-libjpeg -platform win32-g++
$ configure.exe -fast -debug -shared -qt-zlib -qt-libmng -qt-libtiff
-qt-gif -qt-libpng -qt-libjpeg -platform win32-g++
MinGW64 (shared): (note: configure.exe is in the qtbase directory, have to download the .zip, not the .tar.gz!)
-----------------
$ configure.bat -debug -shared -platform win32-g++ -nomake tests -nomake examples -skip declarative -opengl desktop
Visual C++ 2008 (static):
-------------------------
$ "c:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"
$ configure.exe -fast -release -static -qt-zlib -qt-libmng -qt-libtiff
-qt-gif -qt-libpng -qt-libjpeg -platform win32-msvc2005
-no-style-windowsvista
$ configure.exe -fast -debug -static -qt-zlib -qt-libmng -qt-libtiff
-qt-gif -qt-libpng -qt-libjpeg -platform win32-msvc2005
-no-style-windowsvista -no-qmake
- When Qt has been installed the environment variables have to be updated (only
needed for MinGW):
set QTDIR=<qt_installation_path>
set PATH=%SystemRoot%\System32
set PATH=%PATH%;<qt_installation_path>\bin
set QMAKESPEC=win32-g++
(open a command prompt and copy/paste following commands, use then this
prompt to compile. Alternatively a bat-file with the following commands can
be created)
================================================================================
3.2.2) MinGW
================================================================================
- Install MSys and MingGW from http://www.mingw.org
(When installing MinGW following components have to be selected:
- C-compiler
- Fortran-compiler
- MinGW-make)
- MinGW must be installed in C:\Programme\MinGW !!!
(Necessary when dpuser-scripts should be converted and compiled as C-code)
- add 'C:\Programme\MinGW\bin' and 'C:\Programme\msys\1.0\bin' to the
PATH environment variable
================================================================================
3.2.2.1) Compiling DPUSER
================================================================================
- Change into the 'dpuser' directory and execute following command:
$ mingw32-make
- For a debug version type:
$ mingw32-make DEBUG=-g
================================================================================
3.2.2.2) Compiling QFitsView
================================================================================
- Change into the 'QFitsView' directory and execute following commands:
$ mingw32-make
- For a debug version type:
$ mingw32-make debug
================================================================================
3.2.3) Visual C++ 2008 Express Edition
================================================================================
- Download and install Microsoft Visual C++ 2008 Express Edition
- If you want to create parallel code with openmp, copy the following files:
bin/WIN/VC2008distrib/vcomp.lib,vcompd.lib to
Program Files/Microsoft Visual Studio 9.0/VC/lib
bin/WIN/VC2008distrib/omp.h,ompassem.h to
Program Files/Microsoft Visual Studio 9.0/VC/include
bin/WIN/VC2008distrib/vcomp90.dll,vcomp90d.dll to
C:/WINDOWS
- environment variable QTDIR has to be set to C:\Qt\4.3.5.vs.static
================================================================================
3.2.3.1) Compiling DPUSER
================================================================================
- open dpuser/dpuser.sln and type F7
================================================================================
3.2.3.2) Compiling QFitsView
================================================================================
- open QFitsView/QFitsView.sln and type F7
If QFitsView.pro-file has been updated, follwing steps have to be performed to
update QFitsView.sln automatically (resp. QFitsView_VS.vcproj will be updated):
- in cmd-shell call
"c:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"
- cd dpuser\QFitsView
- set QMAKESPECS=win32-msvc2005
- \qt\4.3.5.vs.static\bin\qmake -t vcapp QFitsView.pro CONFIG+=vs_proj
- then open QFitsView.sln in VS
- update following settings in the QFitsView-Project Settings:
Linker > Input> Ignore Specific Library
in Release Configuration:
add "libcmt.lib"
in Debug Configuration:
add "libcmt.lib;libcmtd.lib;msvcrt.lib"
- type F7
================================================================================
3.2.4) CYGWIN
================================================================================
- Install cygwin from www.cygwin.com
- Additional packages:
Devel -> gcc-g++, gcc-g77, make
Libs -> libpng12-devel, libncurses-devel, readline
================================================================================
3.2.4.1) Compiling DPUSER
================================================================================
- cd to dpuser directory and "make CYGWIN=-y"
================================================================================
4) DPUSER Documentation
================================================================================
There exist two sources to get help on DPUSER:
- Type help in DPUSER
or
- http://www.mpe.mpg.de/~ott/dpuser/index.html
The documentation data itself is located in dpuser/doc. It is created via
dpuser-scripts. The ACTUAL HELP TEXTS are stored in "functions.txt" and
"procedures.txt". It is important that all text belonging to a specific keyword
is located on a single line for correct parsing. Accepted keywords are:
"Syntax", "Arguments", "Switches", "Returns", "Examples", "See also", "Notes".
Additionally "<br>" can be added at the end of a line to insert a line break. If
a function or procedure is obsolete, add " (obsolete)" after the name. The
obsolete-string will only appear in the DPUSER-help and in the html-file of the
corresponding function or procedure.
How to create help:
-------------------
- start dpuser in directory /doc and execute makehelp.dpuser
- lookup index.html in directory www with your favourite web browser!
- recompile your DPUSER and help will also be available there
What makehtml_master.dpuser does:
- HTML help:
- Html-files of each function and procedure are generated via
makehtml.dpuser (calls makehtmlsum.dpuser to create the summary
html-files, one for all functions and one for all procedures)
- If an explaining picture should be created for a function, it has to be
defined in the script graphs.dpuser, it will then be generated automati-
cally when calling makehtml.dpuser
ATTENTION: Works only when pgplot has been compiled with PNG.
- Then the complete webpage can be created with the script makewww.html in
the www directory
- At last call makesearch.dpuser to create the search index database (takes
a while, creates index.js)
- All pg...-html-files are supplied statically.
- DPUSER help:
- makec.dpuser creates help.h, which can be compiled into DPUSER
================================================================================
5) Create a distribution
================================================================================
A distribution can be created under LINUX. Best practice is to checkout a virgin
version of the dpuser-package! This way all accumulated superfluous files are
disposed and even more important: when creating the distribution all .svn- and
obsolete-folders are deleted! Change to dpuser-folder and execute:
$ make dist
The distribution is saved in the top folder as dpuser-rXXX.tar.gz, where XXX is
the actual revision number of subversion.
================================================================================
6) Using ds9 together with DPUSER
================================================================================
DPUSER provides a host interface allowing to display images or overlay graphics.
(search DPUSER-help for sao). Therefore following software has to be downloaded
from http://hea-www.harvard.edu/RD/ds9/
- ds9 binaries, version 5.2 or newer
- XPA binaries, version 2.1.9 or newer
(both available for Linux, Win and MacOS X)
XPA provides a little program called xpans which has to run before starting ds9.
Either start xpans manually or set environment variables, so it can be found
automatically when ds9 is started.
It doesn't matter whether DPUSER or ds9 is started first. ds9 must be running at
latest, when a sao-function is called.
================================================================================
7) Functionality/Problem table
================================================================================
|-----------------------------------------------------------------------------|
| | Problems | Reasons |
|-----------------------------------------------------------------------------|
| Linux | none | |
|-----------------------------------------------------------------------------|
| Mac(Intel & PPC)| none | |
|-----------------------------------------------------------------------------|
| Win/MinGW | - dpuser-scripts can't | - dpuser.dll needs exported |
| (Qt static) | be compiled | functions and variables |
|-----------------------------------------------------------------------------|
| Win/MinGW | - DPUSER and QFitsView | - our aim is to provide a |
| (Qt shared) | need shared libraries | monolithic binary |
| | to run | |
|-----------------------------------------------------------------------------|
| Win/VS | - dpuser-scripts can't | - dpuser.dll needs exported |
| (Qt static) | be compiled | functions and variables |
| | - no ds9 support | - xpa-lib has to be |
| | | compiled with VS |
|-----------------------------------------------------------------------------|
| Win/VS | - NOT SUPPORTED ! | - use MinGW shared |
| (Qt shared) | | version instead |
|-----------------------------------------------------------------------------|
| Win/Cygwin | - read/write of | - libz from cygwin |
| | compressed files | doesn't work ?!? |
|-----------------------------------------------------------------------------|
The make targets available to adress the different solutions are listed in
section 8.
================================================================================
8) make-targets
================================================================================
|-----------------------------------------------------------------------------|
| LINUX / MACOS |
|-----------------------------------------------------------------------------|
| | DPUSER | QFitsView | QT-library |
|-----------------------------------------------------------------------------|
| | (make) | (make) | static |
| | dpuser | (make release) | |
| | | QFitsView | |
| | | | |
| | (make DEBUG=-g) | (make debug) | static |
| | dpuserD | QFitsViewD | |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| WINDOWS |
|-----------------------------------------------------------------------------|
| | DPUSER | QFitsView | QT-library |
|-----------------------------------------------------------------------------|
| mingw | (make) | (make) | shared |
| | dpuser.exe | (make release) | |
| | | QFitsView.exe | |
| | | | |
| | (make DEBUG=-g) | (make debug) | shared |
| | dpuserD.exe | QFitsViewD.exe | |
| | | | |
| | | (make release_static) | static |
| | | QFitsView.exe | |
|-----------------------------------------------------------------------------|
| VS | dpuser.exe | QFitsView.exe | static |
| | dpuserD.exe | QFitsViewD.exe | |
|-----------------------------------------------------------------------------|
================================================================================
9) Deployment
================================================================================
Basic usage of cmake:
for DPUSER/Windows:
cd SVNROOT/dpuser
mkdir build
cd build
cmake -G "MinGW Makefiles" ..
cmake --build . --parallel
dpuser Deployment on MacOS (universal binary x86_64 and arm64)
--------------------------------------------------------------
1. On Intel Mac, build using "make", strip binary
2. copy that executable to the Apple Silicon Mac
3. on Arm Mac, build using "cmake", strip binary
4. lipo -create -output dpuser <x86_64>dpuser <arm64>dpuser
QFitsView Deployment on MacOS (universal binary x86_64 and arm64)
-----------------------------------------------------------------
0. On Intel Mac, cleanup like so: cd dpuser/parser; make clean; cd ../mpfit/parser; make clean; cd ..; make clean; make
1. On Intel Mac, build using "make"
2. macdeployqt QFitsView.app -dmg
3. tar -cvzf QFitsView.tgz QFitsView.app
4. copy that tgz to the Apple Silicon Mac
5. in $HOME, tar -xvzf QFitsView.tgz
6. on Arm Mac, build using "cmake"
7. macdeployqt QFitsView.app -dmg
8. execute universalBinary.dpuser
9. rm QFitsView.dmg
10. macdeployqt QFitsView.app -dmg
Alternate deployment on MacOS universal binary
----------------------------------------------
- create universal versions of *.a with lipo in a separate dir
- edit CMakeLists.txt to use that dir for libs
- cmake .. -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" -DCMAKE_OSX_DEPLOYMENT_TARGET="10.15"
- cmake --build . --parallel
- rsync ../resources/telescope.icns QFitsView.app/Contents/Resources/
- for dpuser: cmake .. -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" -DHAS_PGPLOT=OFF
the latter then works also for MacOS 10.13
dpuser Deployment on LINUX (macir26)
------------------------------------
use make, strip dpuser
QFitsView Deployment on LINUX (macir26)
---------------------------------------
user make, strip QFitsView
Note: This still uses qt599, since this has no trouble with fonts
dpuser and QFitsView Deployment on WINDOWS
------------------------------------------
use cmake .. -G "MinGW Makefiles"
|
