Earth Observation Simulator (EO-Sim)

Description of Repositories

• instrupy

InstruPy is a python package to calculate (satellite) observation data metrics for a given instrument and associated viewing geometry (access events).

• orbitpy

OrbitPy is a python package which contain set of modules to compute mission-data (orbits, coverage, contacts, etc.) of satellites.

• eosim-gui

EOSim-GUI is a python package which is a graphical user interface (GUI) to the OrbitPy and InstruPy packages.

Installation

The packages must be installed in the following order. The detailed instructions on how to install them are given in the respective package README / documentation.

1. instrupy
2. orbitpy
3. eosim-gui

The following sequence of linux commands can be tried when installing in Ubuntu 22.04.1 LTS 64-bit with Miniconda3-py310_23.1.0-1-Linux-x86_64. Please see the parent repositories for detailed instructions.

• Install miniconda.

• Clone the 'instrupy', 'orbitpy' and 'eosim-gui' repos to the local drive.

• Install InstruPy

sudo apt update sudo apt install build-essential which gfortran sudo apt install gfortran gfortran --version conda create --name dsh python=3.8 conda activate dsh conda install pip cd instrupy make make runtest 

• Install OrbitPy

cd orbitpy make make runtest 

• Install GTests to run tests of propcov (https://www.eriksmistad.no/getting-started-with-google-test-on-ubuntu/)

sudo apt-get install libgtest-dev sudo apt-get install cmake # install cmake cd /usr/src/gtest sudo cmake CMakeLists.txt sudo make # copy or symlink libgtest.a and libgtest_main.a to your /usr/lib folder cd /usr/src/gtest/lib sudo cp *.a /usr/lib 

• Run propcov C++ tests

cd propcov cd tests make all make runtest 

• Install EOSim-GUI

conda install -c conda-forge cartopy cd eosim-gui make 

• Test the installation by executing:

python bin/eosimapp.py 

If it fails with the error message: “ImportError: you must compile the Fortran code first. f2py -m lowtran7 -c lowtran7.f numpy.core.multiarray failed to import”, then run the below command and test again. Also test that the InstruPy package works properly.

pip install numpy --upgrade --ignore-installed python bin/eosimapp.py 

cd instrupy make make runtest 

Credits and Acknowledgments

This work has been funded by grants from the National Aeronautics and Space Administration (NASA) Earth Science Technology Office (ESTO) through the Advanced Information Systems Technology (AIST) Program.

Questions?

Please contact Vinay Ravindra (vinay.ravindra [at] nasa.gov or vravindra [at] baeri.org)
Bay Area Environment Research Institute, Moffett Field, CA 94035, USA
NASA Ames Research Center, Moffett Field, CA 94035, USA