SPICE Toolkit Installation Instructions =========================================================================== This document describes how to install the SPICE TOOLKIT package on PC computers using MICROSOFT WINDOWS operating system and INTEL FORTRAN 64BIT compiler. We recommend that at a minimum you look over the sections "System Requirements" and "Installing the SPICE TOOLKIT Package" before you begin installing the SPICE TOOLKIT package. We also strongly recommend that you not try to port this package to any other environment without first consulting NAIF. By saying "porting" we mean trying to build this package on a different computer hardware or operating system type, or using a different compiler brand or a different version of the compiler used to build this package, or changing any compile options, such as optimization level, that are used in the script(s) building the libraries included in this package. Detailed information about the system on which this package was compiled and tested is provided in the section "Recompiling the Toolkit" below. In addition to this document there are two text files provided with this package that may be of interest: dscriptn.txt contains a description of the directory structure and contents of the SPICE TOOLKIT package. whats.new describes new features available in this version of the SPICE TOOLKIT package. System Requirements -------------------------------------------------------- Before you begin installing the SPICE TOOLKIT package, you should make sure that you have approximately 150 Megabytes of free diskspace. After the toolkit has been imported you can delete the file toolkit.zip to free up approximately a half of space used during the installation. Time for Installation. The amount of time required to perform the installation varies, but a typical installation takes a few minutes. If you already have a SPICE TOOLKIT Package You should backup and move (or remove) any previous editions of the SPICE TOOLKIT Package from the directory where you plan to install this toolkit. Otherwise this toolkit may be merged with the previous edition leading to unpredictable results. Installing the SPICE Package -------------------------------------------------------- You should move the file toolkit.zip to the directory where you want to install the SPICE TOOLKIT Package. (Note: If you are copying the "toolkit.zip" file via ftp you should copy it in "binary" mode.) After that you should un-zip this file using the Windows built-in un-zip option or a third party un-zip utility. Un-zipping toolkit.zip will create the toolkit directory structure and place the toolkit files in that directory structure. If you experience problems with the installation process, re-check to make sure you have adequate disk space for the toolkit extraction. Toolkit Documentation -------------------------------------------------------- The Toolkit contains two styles of documentation: a plain text version and a hyperlinked html version. NAIF recommends you use the html version because of the convenience of the hyperlinking. To do that load the top level index of the html documentation -- toolkit/doc/html/index.html -- into a web browser. Recompiling the Toolkit -------------------------------------------------------- All libraries and executable programs in this package have been pre-compiled and build for your convenience. Usually it is not necessary to recompile them after you have imported the Toolkit -- you can link to the libraries and run the executables ``as is''. In some cases though, for example if you are using an earlier version of the same compiler and/or operating system, it may be necessary to re-build the Toolkit. To recompile all libraries and programs provided in this package, open DOS window using ``command'' program, execute the ``ifortvars.bat'' script provided with the Intel Fortran compiler to define the required environment variables, change to the top level toolkit directory, and run the ``makeall.bat'' script as follows: .\makeall.bat If you experience problems performing this operation, contact NAIF for further assistance. This package has been pre-compiled on a PC with Intel(R) Xeon(R) W-2225 CPU running Windows 10 Enterprise 20H2 using Intel Fortran compiler 2021.4.0 in 64-bit mode. Disclaimer -------------------------------------------------------- THIS SOFTWARE AND ANY RELATED MATERIALS WERE CREATED BY THE CALIFORNIA INSTITUTE OF TECHNOLOGY (CALTECH) UNDER A U.S. GOVERNMENT CONTRACT WITH THE NATIONAL AERONAUTICS AND SPACE ADMINISTRATION (NASA). THE SOFTWARE IS TECHNOLOGY AND SOFTWARE PUBLICLY AVAILABLE UNDER U.S. EXPORT LAWS AND IS PROVIDED "AS-IS" TO THE RECIPIENT WITHOUT WARRANTY OF ANY KIND, INCLUDING ANY WARRANTIES OF PERFORMANCE OR MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE OR PURPOSE (AS SET FORTH IN UNITED STATES UCC SECTIONS 2312-2313) OR FOR ANY PURPOSE WHATSOEVER, FOR THE SOFTWARE AND RELATED MATERIALS, HOWEVER USED. IN NO EVENT SHALL CALTECH, ITS JET PROPULSION LABORATORY, OR NASA BE LIABLE FOR ANY DAMAGES AND/OR COSTS, INCLUDING, BUT NOT LIMITED TO, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND, INCLUDING ECONOMIC DAMAGE OR INJURY TO PROPERTY AND LOST PROFITS, REGARDLESS OF WHETHER CALTECH, JPL, OR NASA BE ADVISED, HAVE REASON TO KNOW, OR, IN FACT, SHALL KNOW OF THE POSSIBILITY. RECIPIENT BEARS ALL RISK RELATING TO QUALITY AND PERFORMANCE OF THE SOFTWARE AND ANY RELATED MATERIALS, AND AGREES TO INDEMNIFY CALTECH AND NASA FOR ALL THIRD-PARTY CLAIMS RESULTING FROM THE ACTIONS OF RECIPIENT IN THE USE OF THE SOFTWARE. How to Contact NAIF -------------------------------------------------------- If you have problems or suggestions you can contact NAIF via U.S. Mail, electronic mail or phone as specified below. U.S. Mail address: Boris Semenov Jet Propulsion Laboratory Navigation Ancillary Information Facility 4800 Oak Grove Drive Mail Stop 301-125L Pasadena, CA 91109 Electronic mail address: Matthew.J.Barnes@jpl.nasa.gov Nathaniel.J.Bachman@jpl.nasa.gov Marc.Costa.Sitja@jpl.nasa.gov Boris.V.Semenov@jpl.nasa.gov Fraser.S.Thomson@jpl.nasa.gov Edward.D.Wright@jpl.nasa.gov Phone number: (818) 354-7454 (Nat Bachman) (818) 354-5942 (Matt Barnes) (818) 354-4852 (Marc Costa) (818) 354-8136 (Boris Semenov) (818) 354-1842 (Fraser Thomson) (818) 354-0371 (Ed Wright)