The FPOSS Software

What is FPOSS ?

The Fibre Positioner Observation Support Software (FPOSS) is the fibre configuration program for the preparation of FLAMES observations. It takes as input a file containing a list of target objects and generates a configuration in which as many fibres as possible are allocated to targets, allowing for the various instrumental constraints and any specified target priorities. It produces a file containing a list of allocations of fibres to targets, the so-called target setup file. This file needs to be included in one or more Observation Blocks (OBs) created with P2PP. An example FPOSS setup file is provided below.

Current Version: FPOSS-P98 [revision 284998]

Supported Platforms

The current version of the FPOSS has been validated for use on various Linux distributions (including Scientific Linux, Fedora, openSuse and Ubuntu), including BOTH 32-bit AND 64-bit systems and for Mac OS X (versions 10.7 – 10.11).

Click here to jump to the Mac OS X instructions.

Linux

Installation and execution of FPOSS does require a certain number of system libraries to be pre-installed on your machine. For most 32-bit systems these pre-requisites will be automatically satisfied, but for 64-bit systems it is likely that some, or all, of the necessary 32-bit compatibility libraries will be missing. Therefore, please make sure the following relevant software packages are installed on your computer before going any further otherwise the installation process will fail.

Click here to jump to the 32bit Linux instructions.

64-bit systems

RPM based distributions (e.g. Fedora, Redhat, Scientific Linux)

You will need to install 32-bit compatibility libraries and X11 fonts, and tk/tcl 8.5. Assuming you have administrator privileges, then in a terminal execute the following command:

sudo yum install glibc.i686 libX11.i686 xorg-x11-fonts-100dpi.noarch xorg-x11-fonts-75dpi.noarch libXScrnSaver.i686 tk.i686 tcl.i686

If you have a reasonably recent versions of a distribution (e.g. fedora 21 or newer) the default version of tcl/tk either always was (fedora 22 and above) or has since become 8.6 and in this case you will need to install the 8.5 versions which come packaged in the distribution tarball – see below. In this case the 8.6 versions installed by the above command are then not needed.

Package names and installer commands may vary depending on the distribution, for example on OpenSuse, use:

sudo zypper install glibc-32bit libX11-6-32bit xorg-x11-fonts libtk8.5-32bit libtcl8.5-32bit

Debian-Pkg based distributions (e.g. Debian, Ubuntu)

You will need to install 32-bit compatibility libraries and X11 fonts. Assuming you have administrator privileges, then in a terminal execute the following command:

sudo apt-get install libc6-i386 libx11-6:i386 xfonts-100dpi xfonts-75dpi libtk8.5:i386 libtcl8.5:i386

Installation Procedure

To install FPOSS, you will need to retrieve the tarball for your operating system, unpack and install it. If you needed to install any of the X11 packages as described above, then you probably need to logout and log back in before trying to run FPOSS, so you may as well do that now.

The FPOSS installation will by default install the software into several subdirectories of your home directory, but since there is no uninstall script, removing it at a later date can be non-trivial. We therefore recommend the following installation procedure:

/bin/bash
mkdir -pv $HOME/FPOSS/P98
cd $HOME/FPOSS/P98
wget ftp://ftp.eso.org/pub/usg/fposs/P98/fpossLIN64_P98.tar.gz
export HOME=$(pwd)
tar -zxvf fpossLIN64_P98.tar.gz
./fposs_install.sh
bin/fposs.sh -f fpossLIN64/test/M67.fld -ut '2017 01 01.5'

If you don't have wget installed (and don't want to install it) then download the 64bit tarball from here fpossLIN64_P98.tar.gz [5.4 Mbytes compressed] and save it in the $HOME/FPOSS/P98 as above.

If you have a Linux distribution which does not support tcl/tk 8.5, then add the '-r' command line option to the installation command above, i.e.

./fposs_install.sh -r

FPOSS should start after the last command above. If it doesn't please double check you followed all the steps described above exactly, and once you have done that and if it is still failing, please contact ESO User Support. This is best done by clicking on the link “Ask for help” within the User Portal (in the Help card), or sending an e-mail to usd-help@eso.org.

Once you have successfully started FPOSS as described above, then you should (in the same window as you performed the above commands) do the following to double check that everything is correctly installed:

exit
$HOME/FPOSS/P98/bin/fposs.sh

If this also works then you should perhaps update your login configuration file (.bashrc for bash, .tcshrc or .cshrc for tcsh, etc) to append or prepend ${HOME}/FPOSS/P98/bin to your PATH environment variable, e.g. for bash the line to add would be something like:

export PATH=${PATH}:${HOME}/FPOSS/P98/bin

Once you have done this you can then start FPOSS as follows:

fposs.sh
See the section below incase you wish to remove FPOSS.

32-bit systems

RPM based distributions (e.g. Fedora, Redhat, Scientific Linux)

You will need make sure the required libraries and X11 fonts are already installed. Assuming you have administrator privileges, then in a terminal execute the following command:

sudo yum install glibc libX11 xorg-x11-fonts-100dpi.noarch xorg-x11-fonts-75dpi.noarch tk tcl

Note that the 32-bit FPOSS distribution relies on TCL/TK version 8.4. As even Fedora-14 provides version 8.5, if you already have version 8.4 elsewhere in your ssyetm, e.g. /usr/local, and then you will can to set the following environment variable:

export TCL_LIBRARY=/usr/local/lib/tcl8.4

Alternatively, you can use the '-r' command line option to the floss_install.sh script (see below) to have the installer script install the version it needs.

Debian-Pkg based distributions (e.g. Debian, Ubuntu)

You will need make sure the required libraries and X11 fonts are already installed. Assuming you have administrator privileges, then in a terminal execute the following command:

sudo apt-get install libc6-i386 libx11-6 xfonts-100dpi xfonts-75dpi libtk8.5 libtcl8.5

Installation Procedure

To install FPOSS, you will need to retrieve the tarball for your operating system, unpack and install it. If you needed to install any of the X11 packages as described above, then you probably need to logout and log back in before trying to run FPOSS, so you may as well do that now.

The FPOSS installation will by default install the software into several subdirectories of your home directory, but since there is no uninstall script, removing it at a later date can be non-trivial. We therefore recommend the following installation procedure:

/bin/bash
mkdir -pv $HOME/FPOSS/P98
cd $HOME/FPOSS/P98
wget ftp://ftp.eso.org/pub/usg/fposs/P98/fpossLIN64_P98.tar.gz
export HOME=$(pwd)
tar -zxvf fpossLIN32_P98.tar.gz
./fposs_install.sh
bin/fposs.sh -f fpossLIN32/test/M67.fld -ut '2017 01 01.5'

If you don't have wget installed (and don't want to install it) then download the 64bit tarball from here fpossLIN32_P98.tar.gz [5.9 Mbytes compressed] and save it in the $HOME/FPOSS/P98 as above.

If you have a Linux distribution which does not support tcl/tk 8.4, then add the '-r' command line option to the installation command above, i.e.

./fposs_install.sh -r

FPOSS should start after the last command above. If it doesn't please double check you followed all the steps described above exactly, and once you have done that and if it is still failing, please contact ESO User Support. This is best done by clicking on the link “Ask for help” within the User Portal (in the Help card), or sending an e-mail to usd-help@eso.org.

Once you have successfully started FPOSS as described above, then you should (in the same window as you performed the above commands) do the following to double check that everything is correctly installed:

exit
$HOME/FPOSS/P98/bin/fposs.sh

If this also works then you should perhaps update your login configuration file (.bashrc for bash, .tcshrc or .cshrc for tcsh, etc) to append or prepend ${HOME}/FPOSS/P98/bin to your PATH environment variable, e.g. for bash the line to add would be something like:

export PATH=${PATH}:${HOME}/FPOSS/P98/bin

Once you have done this you can then start FPOSS as follows:

fposs.sh
See the section below incase you wish to remove FPOSS.

Removing FPOSS

If you no longer need FPOSS, the software can then be removed by simply by deleting the FPOSS directory and all sub-directories, for example, assuming you followed the instructions above:

rm -fr ${HOME}/FPOSS/P98

or

rm -fr ${HOME}/FPOSS

if you wish to completely remove all trace of FPOSS!

Mac OS X

The Mac OS X version of FPOSS has been tested and verified on OS X 10.7 – 10.11. From OS X 10.10 onward it is fully integrated in X11, prior to this it runs in a kind-of TCL/TK specific environment, so the windows look a little different but the functionality is identical, except in one small way, which is that when saving a setup, the default file name is not provided, you therefore have to makeup your own filenames. Once the FPOSS package is installed, please keep to the standard naming convention for the INS setup files by using the following command:

fposs.fixINSfilename <INS_file>

The Mac OS X version of FPOSS is distributed via Macports, though for the moment it has not yet been officially integrated into the ESO Macports repository. Since it depends on Macports, it also therfore depends on Xcode and the Xcode Command line tools, see the MacPorts installation guide.

Please note that you will need administrator privilege to be able to complete the installation via MacPorts, i.e. you need to be able to run commands via "sudo").

As mentioned above, for Mac OS X 10.10 and above, FPOSS also depends on an X11 server. By default the Macports installation will include the dependency on the Macports package xorg-server (i.e. it will be installed automatically if needed). If this will need to be installed, then you will need to logout and then log back in to "activate" X11 before continuing (if you copy and paste the commands below, it will automatically tell you if you need to do this). Alternatively, you can rely on XQuartz, if you already have it installed, or you can install it before beginning the proceedure below (if you install XQuartz it too will prompt you to logout and back in again to activate the XQuartz X11 server).

Once you have an up and running Macports system, in a terminal please follow the procedure described below to install the flames-fposs Macports package (we recommend you copy and paste the commands):

/bin/bash
x11_tobe_installed=true ; port installed | grep xorg-server >/dev/null 2>&1 || [ -d /Applications/Utilities/XQuartz.app ] && x11_tobe_installed=false
sudo port install ftp://ftp.eso.org/pub/usg/fposs/P98/macports/flames-fposs.bz2 $([ -d /Applications/Utilities/XQuartz.app ] && echo -x11 +xquartz)
$x11_tobe_installed && echo "You must logout and then login again to activate X11 before continuing"

Logout and then login again to activate X11 before continuing if advised to do so. Then you should be able to start FPOSS as follows:

/opt/local/bin/fposs.sh -f /opt/local/share/fposs/test/M67.fld -ut '2017 01 01.5'

FPOSS should start after the last command above. If it doesn't please double check you followed all the steps described above exactly, and once you have done that and if it is still failing, please contact ESO User Support. This is best done by clicking on the link “Ask for help” within the User Portal (in the Help card), or sending an e-mail to usd-help@eso.org.

Once you have successfully started FPOSS as described above, then you should perhaps update your login configuration file (.bashrc for bash, .tcshrc or .cshrc for tcsh, etc) if /opt/loca/bin is not already included in your PATH environment variable, e.g. for bash the line to add would be something like:

export PATH=${PATH}:/opt/local/bin

Once you have done this you can then start FPOSS as follows:

fposs.sh

Removing FPOSS

If you no longer need FPOSS, the software can then be removed with a simple macport command:

sudo port uninstall flames-fposs


FPOSS Users' Manual

  • FPOSS User Manual (on the FLAMES documentation web page) The User Manual includes a step-by-step demonstration of using the software.

 

 

 

Please also check further the FPOSS Requirements and Recommendations

FPOSS Example setup file

As part of preparing a proposal, you may want to use p2pp to get an accurate idea of the execution time for different OB configurations. In order to calculate the execution time, p2pp must have an FPOSS setup file attached to the acquisition template, but you may not want go through the (non-trivial) process of installing the FPOSS software and creating an FPOSS setup, just to prepare the proposal. In that case download the FPOSS setup file below and attach that to your OBs for the purposes of experimenting with OB execution times. It doesn't matter that the setup below is possibly not the instrument mode you wish to use, the execution time calculated by p2pp is independent on the details of the setup (except when you use the argfast template, but then you don't need an FPOSS setup file in order to be able to compute the OB execution time).
 
 

 

 

Instrument selector

This page is specific to FLAMES