STARE/INSTALL at master · captainkirk99/STARE · GitHub

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

# INSTALL

Notes on installation.

Dependencies:

1. STARE library
  C++ (std11)
  ERFA (included) - Essential Routines for Fundamental Astronomy - https://github.com/liberfa/erfa
  CUTE (included) - https://cute-test.com/

2. PySTARE: Python interface using SWIG
  Python3, Numpy, SWIG

###########################################################################
#
# CMake build
#
# Out-of-source build. Assume ./STARE is the TOPDIR.
#
# Products:
#   libSTARE.a and PySTARE.so (if built) will be in build/default/src
#   tests will be in build/default/tests
#   ./STARE/include contains the headers
#

# The default location for CMAKE_INSTALL_PREFIX is /usr/local (UNIX)
#	or c:/Program Files (Windows). Running the below cmake command will
#	set it to $prefix/deps. If you wish to install it elsewhere, simply
#	set the environment variable to your preferred location.

# The PYTHON_INCLUDE_DIRS environment variable can be set to the locations
# of python and numpy/core include directories. See src/CMakeLists.txt for
# how the include_directories is set.

mkdir build; cd build
cmake ..
make

# To make a source distribution after running cmake...

make dist

# To install the include files and library, try the following.

mkdir build; cd build
cmake -DCMAKE_INSTALL_PREFIX:PATH=< install_path > ..
make test
make install

# Optimization flags may be set via an environment variable OPTFLAGS or via
# the cmake invocation as
cmake -DOPTFLAGS="-O2"
# Note the default is set to "-O3".

###########################################################################
#
# Testing - Simple
#
# To run tests, after making the library as above, try the following
# in the build directory.
#
# For tests to find the data files you  may need to set the following
# environment variable to the TOPDIR as follows.
#
# export STARE_SRC_HOME=/Users/mrilee/git/STARE/
#

make test

###########################################################################
#
# Testing - ctest
#
# CMake provides a useful framework for testing.
#
# To run tests, after making the library as above, try the following
# in the build directory.

ctest

# For performing Valgrind-based memory tests, rerun cmake and test as follows.
cmake -DOPTFLAGS="-O0" ../STARE
make
ctest -T memcheck
# which will produce a number of logs and analyses of the memory integrity.


###########################################################################
#
# Ubuntu 18.04 additional comments
#

sudo apt install cmake # Might need to manually update to 3.15+
sudo apt install swig
# sudo apt install liberfa-dev # optional, STARE contains a copy
sudo apt install python3-numpy
sudo apt install python3-dev
sudo apt install g++

###########################################################################
#
# CentOS 7 additional comments
#

sudo yum install epel-release
# sudo yum install erfa-devel.x86_64 # optional, STARE contains a copy
sudo yum install swig
sudo yum install cmake3 # Might have to manually update to 3.15+
sudo yum install gcc-c++
sudo yum install python36-devel.x86_64
sudo yum install devtoolset-3-gcc devtoolset-3-gcc-c++
scl enable devtoolset-3 bash


###########################################################################
#
# STARE SpatioTemporal Adaptive Resolution Encoding

An encoding for high-performance search and subsetting of geospatial data.

Development supported by NASA/ACCESS-17.

Copyrights and licenses as asserted in individual files. Legacy HTM distributed under GNU/GPLv2.

Copyright (c) 2019 Michael Lee Rilee, RSTLLC, mike@rilee.net