Getting Spacecraft

Spacecraft is distributed as a repository hosted on github.

  1. Install git locally, if needed.

  2. Change directories to some install directory:

    $ cd </some/installation/directory>
    
  3. Locally clone the repository.

    If you may ultimately contribute back to Spacecraft:

    1. Create a github account, if needed.

    2. Fork the fiveladdercon/launchpad repository.

    3. Clone your fork:

      $ git clone https://github.com/<youraccount>/launchpad
      

    If you’re just poking around:

    1. Clone the fiveladdercon/launchpad repository directly:

      $ git clone https://github.com/fiveladdercon/launchpad
      

      but realize you’re really on your own and that that any changes you make can’t be merged back in without a github account.

    If in doubt, fork then clone.

  4. Link the appropriate executable for your architecture to spacecraft in the launchpad/bin directory:

    $ cd launchpad/bin
    $ ln -s spacecraft_<version>_<arch> spacecraft
    
  5. Set the SC_LAUNCHPAD environment variable to the local launchpad repository and add the bin sub directory to your path. This needs to happen each time you log in, so these instructions add it to your .profile.

    $ cd ..
    $ echo "export SC_LAUNCHPAD=$PWD"      >> ~/.profile  # Note double quotes
    $ echo 'PATH=$PATH:$SC_LAUNCHPAD/bin'  >> ~/.profile  # Note single quotes
    $ source ~/.profile
    
  6. Try out an example:

    $ cd $SC_LAUNCHPAD/example/
    $ spacecraft -R soc.rf data.pl
    

    Many documented examples can be tried by executing the command in the $SC_LAUNCHPAD/example/ directory.