Build


Build Examples

Before reading the installation instructions below, the following examples are helpful in your own environment. The alpha-dsk example to enable SPICE DSK feature is the following:

Installation Instructions

"FLOW" requires POSIX-compliant operating system (UNIX, Linux, BSD, etc.),and the necessary libraries are properly installed to build it.
- CSPICE  (N0064 or later)
- libxml2 (2.7.6 or later)
- lua     (5.1.4 or later)
- CFITSIO (v3.310 or later) (optional)
- libpng  (1.2.49 or later) (optional)
- jpeglib (6 or later) (optional)

At least one of the CFITSIO, libpng, jpeglib must be installed to generate an image.
The format of textures also depends on these libraries.

If you expand the flow-1.3.tar.gz, flow-1.3 directory will be created. Please use configure script to build the program. The quick example is in below:

$ tar zxvf flow-1.3.tar.gz
$ cd flow-1.3
$ ./configure --with-cspice=/path/to/cspice
$ make
$ su
# make install

If you failed to quickute configure script, please see the configure options.

$ ./configure --help

Required Packages


Lua, libxml2, cspice are required. At least, one of libjpeg, libpng, and CFITSIO must be included to perform rendering. Texture images must be prepared in the specified formats corresponding to the configure options.


Lua options

--with-lua-prefix[=DIR] Use Lua from given prefix.
--with-lua-inc[=DIR] You can also specify Lua's include dir. Default is $LUA_DIR/include
--with-lua-lib[=DIR] You can also specify Lua's library dir. Default is $LUA_DIR/lib
--with-lua-suffix[=SUFFIX] Versioning suffix to use in Lua filenames. Default is "".

Lua is required to compile this software. If configure cannot find lua-related files, compilation will be failed.
Spice options

--with-cspice=DIR Use cspice from given prefix.
--with-cspice-inc=DIR You can also specify cspice's include dir. Default is $CSPICE_DIR/include
--with-cspice-lib=DIR You can also specify cspice's library dir. Default is $CSPICE_DIR/lib

Cspice is required to compile this software. If configure cannot find cspice-related files, compilation will be failed.
libxml2 options
--with-libxml-prefix=DIR Specify location of libxml config
--with-libxml-inc=DIR Specify location of libxml headers
--with-libxml-lib=DIR Specify location of libxml libraries
libxml2 is required to compile this software. If configure cannot find libxml2-related files, compilation will be failed.

Optional Packages


JPEG support
--without-libjpeg Disable JPEG support
--with-libjpeg[=DIR] Include JPEG support (DIR is libjpeg's install dir).
JPEG support is optional, but it will be included by default if configure finds libjpeg on your system.
Use

--without-libjpeg

to explicitly disable JPEG support.
Use the --with-libjpeg=DIR option to use a copy of libjpeg installed in directory "DIR". Make sure that this copy of libjpeg is compiled before using this option.
PNG support
--without-libpng Disable PNG support
--with-libpng[=DIR] Include PNG support (DIR is libpng's install dir).
PNG support is optional, but it will be included by default if configure finds libpng on your system.
Use

--without-libpng

to explicitly disable PNG support.
Use the --with-libpng=DIR option to use a copy of libpng installed in directory "DIR". Make sure that this copy of libpng is compiled before using this option.
FITS support
Unlike the JPEG and PNG supports, FITS support enables to output a simple FITS output which includes World Coordinated System headers.
--without-cfitsio Disable FITS support
--with-cfitsio[=DIR] Include FITS support (DIR is CFITSIO's install dir).
FITS support is optional, but it will be included by default if configure finds CFITSIO on your system.
Use

--without-cfitsio

to explicitly disable FITS support.
Use the --with-cfitsio=DIR option to use a copy of cfitsio installed in directory "DIR". Make sure that this copy of cfitsio is compiled before using this option.

OGC WMS support
--disable-wms         Disable OGC WMS Client support
--enable-wms         Enable OGC WMS Client support (libcurl required)
OGS WMS support is optional. This option enables users to download a planetary texture from a WMS server.
It requires libcurl (see --with-curl-config option below).
Curl support
--with-curl-config=PATH Specify path to curl-config.
The Curl library (http://curl.haxx.se/libcurl/) is used by the WMS support option to connect to remote servers via HTTP.
If libcurl is installed in the default system directories then it should automatically be detected by configure. Otherwise use the --with-curl-config option to specify the path where the curl-config script is located. e.g.
./configure .... --with-curl-config=/usr/local/bin/curl-config
SPICE DSK support
--enable-spice-dsk Enable SPICE DSK support
(Alpha Test DSK Prototype Toolkit required)
SPICE DSK support is optional. This option enables SPICE DSK Type 2 format in addition to the STL format as a shape model. This option is experimental.
Use --with-cspice=/path/to/alpha_dsk_c option to use a copy of the alpha test DSK Prototype Toolkit (ftp://naif.jpl.nasa.gov/pub/naif/misc/alpha_dsk/).


license and policy

darts c-soda isas jaxa