Procedure

     SPCA2B ( SPK and CK, ASCII to binary )

     SUBROUTINE SPCA2B ( TEXT, BINARY )

Abstract

     Convert a text (ASCII) format SPK or CK file to an equivalent
     binary file, including comments.

Required_Reading

     SPC

Keywords

     FILES

Declarations

     IMPLICIT NONE

     CHARACTER*(*)         TEXT
     CHARACTER*(*)         BINARY

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     TEXT       I   Name of an existing text format SPK or CK file.
     BINARY     I   Name of a binary SPK or CK file to be created.

Detailed_Input

     TEXT     is the name of an existing text format SPK or CK
              file that may contain comments in the appropriate
              SPC format, as written by SPCB2A or SPCB2T. This
              file is unchanged by calling SPCA2B.

     BINARY   is the name of a binary SPK or CK file to be created.
              The binary file contains the same data and comments
              as the text file, but in the binary format required
              for use with the SPICELIB reader subroutines.

Detailed_Output

     None.

Parameters

     None.

Exceptions

     1)  If there is an IOSTAT error while opening, reading, or writing
         a file, the error is signaled by a routine in the call tree of
         this routine.

     2)  If the text file is not in the correct format, an error is
         signaled by a routine in the call tree of this routine.

Files

     See arguments TEXT and BINARY above.

Particulars

     The SPICELIB SPK and CK reader subroutines read binary files.
     However, because different computing environments have different
     binary representations of numbers, you must convert SPK and CK
     files to text format when porting from one system to another.
     After converting the file to text, you can transfer it using
     a transfer protocol program like Kermit or FTP. Then, convert
     the text file back to binary format.

     The following is a list of the SPICELIB routines that convert
     SPK and CK files between binary and text format:

        SPCA2B    converts text to binary. It opens the text file,
                  creates a new binary file, and closes both files.

        SPCB2A    converts binary to text. It opens the binary file,
                  creates a new text file, and closes both files.

        SPCT2B    converts text to binary. It creates a new binary
                  file and closes it. The text file is open on
                  entrance and exit.

        SPCB2T    converts binary to text. It opens the binary
                  file and closes it. The text file is open on
                  entrance and exit

     See the SPC required reading for more information
     about SPC routines and the SPK and CK file formats.

Examples

     This is an example of how to use SPCB2A and SPCA2B for
     transferring files. Suppose A.BSP is a binary SPK file in
     environment 1; to transfer it to environment 2, follow
     these three steps:

        1) Call SPCB2A within a program in environment 1 to convert
           the file to text:

              CALL SPCB2A ( 'A.BSP', 'A.TSP' )

        2) Transfer the text file from environment 1 to environment 2
           using FTP, Kermit, or some other file transfer utility,
           for example,

              ftp> put A.TSP

        3) Call SPCA2B within a program in environment 2 to convert
           the file to binary on the new machine,

              CALL SPCA2B ( 'A.TSP', 'A.BSP' )

Restrictions

     1)  This routine assumes that the data and comments in the
         text format SPK or CK file come from a binary file
         and were written by one of the routines SPCB2A or SPCB2T.
         Data and/or comments written any other way may not be
         in the correct format and, therefore, may not be handled
         properly.

Literature_References

     None.

Author_and_Institution

     J. Diaz del Rio    (ODC Space)
     J.E. McLean        (JPL)
     H.A. Neilan        (JPL)
     W.L. Taber         (JPL)

Version

    SPICELIB Version 1.2.0, 03-JUN-2021 (JDR)

        Added IMPLICIT NONE statement.

        Edited the header to comply with NAIF standard.

    SPICELIB Version 1.1.1, 10-MAR-1992 (WLT)

        Comment section for permuted index source lines was added
        following the header.

    SPICELIB Version 1.1.0, 05-SEP-1991 (HAN)

        Removed declarations of unused variables.

    SPICELIB Version 1.0.0, 05-APR-1991 (JEM)