jvo203 / fitswebql

a high-performance C/C++ FITSWebQL SE (Supercomputer Edition)

FITSWebQL SE

A cleaned-up C/C++ Supercomputer Edition of FITSWebQL, fusing the best elements of the previous versions: Rust (https://github.com/jvo203/fits_web_ql), C/C++ (http://jvo.nao.ac.jp/~chris/fitswebql.html) and SubaruWebQL.

Although Rust is extremely stable there are still some cases where C/C++ outperforms by a large margin, especially when combined with Intel high-performance libraries.

status

incomplete, suspended till further notice: the work continues in a secret project code-named "BACK TO THE FUTURE" or "A BLAST FROM THE PAST" (recently uncloaked, see https://github.com/jvo203/FITSWEBQLSE)

installation

An installation manual for CentOS 7 might need to be adjusted for other operating systems. [need for speed]: we recommend Intel Clear Linux (even, or especially on AMD CPUs)

requirements

1. GCC9 or higher

2. Intel Integrated Performance Primitives (IPP): https://software.intel.com/en-us/intel-ipp

3. a compiler with support for _GLIBCXX_PARALLEL:

   • Intel C/C++ version 19-or-higher for the best performance, which bundles IPP (recently the required uWebSockets library does not work with Intel C/C++, hence either GCC or CLANG are needed)

   • alternatively a recent gcc/clang++ with C++17 plus a manual installation of the free Intel IPP: https://software.intel.com/en-us/intel-ipp

4. an open-source Intel SPMD Program Compiler (ispc): https://ispc.github.io

5. the 809MB-large spectral lines database needs to be downloaded from http://jvo.nao.ac.jp/~chris/splatalogue_v3.db and placed inside the FITSWebQL directory (for example "wget http://jvo.nao.ac.jp/~chris/splatalogue_v3.db")

fitswebql's Issues

wrong check for mmap result

FITSWebQL/src/main_uWS.cpp

Line 1164 in 480095a

if (buffer != NULL)

should check for MAP_FAILED not NULL

    On success, mmap() returns a pointer to the mapped area.  On error,
       the value MAP_FAILED (that is, (void *) -1) is returned, and errno is
       set to indicate the cause of the error.