Installation ============ |project| is released as an all-in-one tarball for Enterprise Linux systems. The tarball, or software bundle, provided by the |cspp_title| (|cspp_abbr|) team includes a python runtime and all of the necessary third-party software to run the features provided by |project|. The tarball uses bash scripts for conveniently calling the python software or utilities provided by third-party vendors. The software bundle is only supported on CentOS-7.9 compatible systems, but has also been tested on Rocky Linux 8.5 and may work on other compatible Linux 64-bit operating systems as well. There are other ways to install |project| on other operating systems, but the instructions to do so are beyond the scope of this documentation. .. ifconfig:: is_geo2grid Please `Contact Us `__ if you have questions about installation. .. ifconfig:: not is_geo2grid Please `Contact Us `__ if you have questions about installation. |project| Software ------------------ .. ifconfig:: is_geo2grid The |project| tarball can be downloaded from the CSPP Geo website: http://cimss.ssec.wisc.edu/csppgeo/ To install the software, unpack the tarball: .. code-block:: bash tar xf CSPP_GEO2GRID_V1.1.tar.gz This will create a |project| software bundle directory, ``geo2grid_v_1_1``. To simplify calling scripts included in the bundle the following line should be added to your ``.bash_profile``: .. code-block:: bash export GEO2GRID_HOME=/path/to/geo2grid_v_1_1 All other environment information needed to run is automatically loaded by the scripts provided by |project|. Scripts are typically invoked using: .. code-block:: bash $GEO2GRID_HOME/bin/ ... To execute commands without including the preceding directory path, or if using in a script in its own background environment, then set the path to include the /bin directory: .. code-block:: bash export PATH=$PATH:$GEO2GRID_HOME/bin The example invocations in this document assume you have added this to your PATH. .. ifconfig:: not is_geo2grid The |project| tarball can be downloaded from the CSPP LEO website: http://cimss.ssec.wisc.edu/cspp/ To install the software, unpack the tarball: .. code-block:: bash tar xf CSPP_POLAR2GRID_V3.0.tar.gz This will create a Polar2Grid software bundle directory, ``polar2grid_v_3_0``. To simplify calling scripts included in the bundle the following line should be added to your ``.bash_profile``: .. code-block:: bash export POLAR2GRID_HOME=/path/to/softwarebundle All other environment information needed to run is automatically loaded by the scripts provided by Polar2Grid. Scripts are typically invoked using: .. code-block:: bash $POLAR2GRID_HOME/bin/ ... To execute commands without including the preceding directory path, or if using in a script in its own background environment, then set the path to include the /bin directory: .. code-block:: bash export PATH=$PATH:$POLAR2GRID_HOME/bin .. note:: A one-time initialization process is performed the first time any of the bash scripts are run. The extracted directory can *NOT* be moved after this is performed. In a shared user installation (multiple users running the same installation), the user that extracted the tarball should run a script to perform this initialization before any other users (ex. ``-h`` to |script_literal|). See :doc:`getting_started` for more information on running |project|. |project| Test Data ------------------- .. ifconfig:: is_geo2grid To confirm a successful installation download the following verification test data set: .. code-block:: bash CSPP_GEO2GRID_V1.1_TEST_DATA.tar.gz The test data should be unpacked in a directory separate from the |project| installation: .. code-block:: bash cd $HOME tar xf CSPP_GEO2GRID_V1.1_TEST_DATA.tar.gz This will create a ``geo2grid_test`` directory containing the test input, output, and verification scripts for the ABI instrument. .. ifconfig:: not is_geo2grid To confirm a successful installation download the following verification test data set: .. code-block:: bash CSPP_POLAR2GRID_V3.0_TEST_DATA.tar.gz The test data should be unpacked in a directory separate from the |project| installation: .. code-block:: bash cd $HOME tar xf CSPP_POLAR2GRID_V3.0_TEST_DATA.tar.gz This will create a ``polar2grid_test`` directory containing the test input, output, and verification scripts for both MODIS and VIIRS instruments. See :doc:`verification/index` for instructions on using the verification test data.