feat: add instructions to install STAREPandas on MacOS M1

README.md

@@ -19,7 +19,7 @@ STAREPandas also extends the geopandas file I/O functionality to load some (rast
 remote sensing granules and tiles (MOD09, MOD09GA, VNP03) through pyhdf and netcdf4.
 
 
-## Installation
+## Installation on Linux
 
 ### pyhdf
 STAREPandas depends on pyhdf to read hdf4-eos granules, requiring libhdf4-dev, to build.
@@ -67,6 +67,139 @@ pip3 install starepandas
 ```
 
 
+## Installation on MacOS M1
+
+#### I.Install STARE on MacOS M1
+1. Create new conda env with python 3.12:
+
+`conda create -n <YOUR_CONDA_ENV> python=3.12`
+
+E.g: `conda create -n stare_3.12 python=3.12`
+
+2. Activate conda env:
+
+`conda activate <YOUR_CONDA_ENV>`
+
+E.g: `conda activate stare_3.12`
+3. Install numpy:
+
+`conda install -c conda-forge numpy`
+
+4. Install cmake:
+
+```
+sudo apt update  
+sudo apt install cmake
+```
+
+or:
+
+`conda install -c conda-forge cmake`
+
+5. Install doxygen & x-code-select:
+
+```
+conda install -c conda-forge doxygen
+xcode-select --install
+```
+
+6. (Optional) May need to link librhash library
+```
+cd /Users/tonhai/miniconda3/envs/<YOUR_CONDA_ENV>/lib
+ln -s librhash.<VERSION>.dylib librhash.0.dylib
+```
+E.g:
+```
+cd /Users/tonhai/miniconda3/envs/stare_3.12/lib
+ln -s librhash.1.4.5.dylib librhash.0.dylib
+```
+
+7. Download & install STARE from source:
+
+```
+git clone https://github.com/SpatioTemporal/STARE  
+cd STARE
+mkdir build
+cd build
+cmake -DCMAKE_OSX_ARCHITECTURES=arm64 \
+      -DCMAKE_OSX_SYSROOT="$(xcode-select --print-path)/SDKs/MacOSX.sdk" \
+      -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 \
+      -DCMAKE_CXX_FLAGS="-isysroot $(xcode-select --print-path)/SDKs/MacOSX.sdk -I$(xcode-select --print-path)/SDKs/MacOSX.sdk/usr/include/c++/v1" \
+      -DSTARE_INSTALL_LIBDIR=lib \
+      -DBUILD_SHARED_LIBS=NO \
+      ../
+make -j4
+sudo make install
+```
+
+8. Check to see if libSTARE.a in /usr/local/lib/ and STARE.h in /usr/local/include/, if not:
+```
+export STARE_INCLUDE_DIR=/path/to/directory-containing-stare.h/  
+export STARE_LIB_DIR=/path/to/directory-containing-stare.a/
+```
+
+E.g.:
+```
+export STARE_INCLUD_DIR=/Users/tonhai/miniconda3/envs/stare_3.12/include/STARE
+export STARE_LIB_DIR=/Users/tonhai/miniconda3/envs/stare_3.12/lib
+```
+
+```
+python3 setup.py build_ext --inplace 
+python3 setup.py bdist_wheel
+python3 setup.py sdist
+```
+
+#### II. Install pystare on MacOS M1
+1. Install setuptools, swig and wheel:
+
+`conda install -c conda-forge setuptools swig wheel`
+
+2. Install xcode-select:
+
+`xcode-select --install`
+
+3. Download pystare, rebuild and install:
+```
+git clone https://github.com/SpatioTemporal/pystare  
+cd pystare  
+export CXXFLAGS="-I$(xcode-select --print-path)/SDKs/MacOSX.sdk/usr/include/c++/v1"
+python3 setup.py build_ext --inplace  
+python3 setup.py bdist_wheel  
+python3 setup.py sdist  
+pip3 install .  
+```
+
+If there is any issue, try to export this and retry:
+
+`export CXXFLAGS="-I/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/c++/v1"`
+
+#### III. Install STAREpandas on MacOS M1
+1. Install setuptools, swig and wheel: 
+
+`conda install -c conda-forge setuptools swig wheel`
+
+2. Install xcode-select:
+
+`xcode-select --install`
+
+3. Export CXXFLAGS
+
+`export CXXFLAGS="-I$(xcode-select --print-path)/SDKs/MacOSX.sdk/usr/include/c++/v1"`
+Or: 
+`export CXXFLAGS="-I/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/c++/v1"`
+
+4. Download STAREPandas, rebuild and install: 
+
+```
+git clone https://github.com/SpatioTemporal/STAREPandas  
+cd STAREPandas  
+python3 setup.py build_ext --inplace  
+python3 setup.py bdist_wheel  
+python3 setup.py sdist  
+pip3 install . 
+``` 
+
 ## Note
 Some of the examples require Rtree-linux to be installed to run geopandas spatial joins. 
 As of 2020-08-20, I could not make this work on Centos7 with rtree>0.9 (9.4) as it requires GLIBCXX_3.4.21. I therefor downgrade rtree to rtree-0.8.3 on Centos7