Skip to content

Executables

This page describes how to obtain precompiled executable files (command-line luna and the destrat utility) for macOS, Windows and Linux.

Please first read the overview describing installation options to find the best option for your platform.

As decribed below, the latest stable binary release is available from this URL: https://github.com/remnrem/luna-base/releases.

Preliminaries

Prior to installing Luna binary executables, we strongly recommend that you figure out how to do the following:

  • figure out to how use your machine's command prompt: for macOS, this is the Terminal; for Windows, this is the Command Prompt. The tutorials and examples assume you are running a bash shell.

  • get a text editor: ensure you have a text editor that works with plain-text files (i.e. not a word processor), either old-school (e.g. emacs, nano, both of which are in the standard luna Docker container) or new-school (e.g. Atom, which is free, or Sublime Text, which is not)

  • get R : the R project for statistical computing is obviously necessary to use lunaR -- but even if you don't plan to use lunaR, it will help when working with Luna output.

lunaC

  1. Visit https://github.com/remnrem/luna-base/releases and select the folder appropriate platform: macOS, Windows or Linux (Ubuntu x86_64)

  2. Go the the command line on your machine, i.e. [Terminal] for macOS.

  3. Fourth unzip/untar the archive, which will extract three files (luna, destrat and behead) into the current directory. (For the Windows download, there will be an additional file, libfftw3-3.dll.)

  4. Test if it works by typing luna or ./luna. You should see something like:

    usage: luna [sample-list|EDF] [n1] [n2] [@parameter-file] [sig=s1,s2] [v1=val1] < command-file
    
    To get the version numnber:
    luna -v
    
    luna-base version v0.24.1 (release date 28-Aug-2020)
    luna-base build date/time Aug 28 2020 09:58:53
    

  5. To enable you to run luna from any folder, place all three (or four) files in a folder that is in your command path (e.g. /usr/local/bin/ or 'C:\Program Files\ for Windows. Alternatively, add the folder containing these files to your Path environment variable.

  6. Mac users may get a security message about running executables downloaded from the web. See below to fix this.

macOS installation notes

When first running Luna, you may encounter the following:

img

This is a standard message, and does not mean that Luna (or the other executables) pose any risk. To fix, go to System Settings / Security & Privacy tab and click the Open Anyway button, and then click on the lock (bottom left) to make the changes:

img

You'll then see a further dialog box pop up, where you should click "Open". This will allow luna to run on the command line.
Do likewise for destrat (and behead). You only need to do this once per new installation. Alternatively, you could always compile from source, or use Docker instead.