What is GASGANO ?
GASGANO is a Data File Organiser developed and maintained by ESO to help its user community to manage and organise in a systematic way the astronomical data observed and produced by all VLT compliant telescopes, i.e. by telescopes which are being operated through Observation Blocks. The tool also supports FITS files which are not generated by those telescopes with limited functionality. For further information, please, refer to the latest GASGANO Users' Manual (Issue 4).
Latest Release
The latest public release of GASGANO is V2.3.0. This GASGANO release
- is compatible with the Common Pipeline Library Release CPL 5.x.. CPL 5.0.0 changed the way it reports errors to clients. As a consequence, the previous GASGANO release V2.2.7 is not compatible with CPL 5.x.
- uses the Java Runtime Environment JRE 6 for improved performance and memory management
- fixes various minor issues
Important Note
If you wish to interface GASGANO to VLT instrument pipeline recipes build on top of the ESO Common Pipeline Library (CPL) and the qfits library, you will have to download and use the specific instrument package available here. In such case, it is not necessary to download GASGANO from this current page, since it will be automatically provided with the specific instrument package. Please, notice that the latter is currently available only for a few VLT instruments.
System Requirements
GASGANO is a Java application verified and supported on
- Java Runtime Environment JRE 6
- Scientific Linux 4.3 on a 32-bit Intel architecture
GASGANO 2.3.0 can be installed on other architectures and operating systems - such as Linux on 64-bit AMD and MacOS X 10.5, but ESO is not able to guarantee that it will work correctly in such environments. Notice that this release of GASGANO is not compatible with older Java Runtime Environments JRE < 6. Should you wish to run GASGANO on MacOS X 10.4 or lower, for which JRE 6 is not available, please use the previous GASGANO release V2.2.7. The system is known to be resource-intensive: see details of memory and CPU usage in Appendix A of the Gasgano User's Manual.
Installation
To install GASGANO V2.3.0 you will need to retrieve the distribution kit, unpack and install it, and start the gasgano executable.
Prerequisites
To use the latest Gasgano version V2.3.0, a Java Runtime Environment 6 must be available on your system. If not, please, download it from the following locations:
Make sure that the java command is in your search path. Type java -version on the command line to verify that the printed java version is 1.6.x. On MacOS X 10.5, you can switch the default Java version using the utility application Java Preferences in /Applications/Utilities/Java .Instructions
- You MUST be under your $HOME directory to install GASGANO V2.3.0:
> cd
- Download the GASGANO Release V2.3.0 into your $HOME directory
- After the FTP transfer, please, verify the checksum value with the cksum command only. Depending on the distribution, it will be:
> cksum gasgano-2.3.0.tar.gz 3522083318 1146497 gasgano-2.3.0.tar.gz
- Backup any existing .gasganorc configuration file you may already
have under $HOME:
> mv $HOME/.gasganorc $HOME/.gasganorc.bck.YYYYMMDD
(where YYYYMMDD is the current date) - Backup any existing $HOME/gasgano/ directory you may already have:
> mv $HOME/gasgano $HOME/gasgano.bck.YYYYMMDD
- Run the following sequence of commands:
> tar xzf gasgano-2.3.0.tar.gz
(if you get a 'broken pipe' error, please, run the gunzip command first, then tar).
This completes the installation process. - To run the Gasgano GUI, create a link to point to the new gasgano version:
> ln -s gasgano-2.3.0 gasgano
- Then, just add $HOME/gasgano/bin to your $PATH environment variable:
> export PATH="$HOME/gasgano/bin:"$PATH
Possible files to update are:$HOME/.bashrc $HOME/.profile
- Finally, enter the command
> gasgano
possibly after issuing rehash. Please, notice that this will create a new default .gasganorc configuration file under $HOME. - If the GASGANO main panel appears, then you have successfully installed GASGANO. You can then delete the compressed TAR file.
- As a last step, please verify that you are running the expected GASGANO 2.3.0 release: check the version number listed at the top of the main GASGANO panel.
GASGANO Users' Manual
The GASGANO Users' Manual (Issue 4) is available for download in PDF format, 1.2 Mbytes. Should you experience any problem when opening the document directly from your web browser (a blank document or some error message), please save the file to disk first, and then open it with Acrobat Reader.
Bug Reports
If you experience an unexpected behavior of GASGANO, please, first refer to the list of main known problems, limitations and possible hints for GASGANO release 2.3.0. For any other issues or requests, please send a report to the ESO User Support Department, describing:
- the GASGANO release you are using
- the version of your OS
- the exact sequence of actions you performed before the bug occurred
- what were precisely the symptoms and the possible error message(s)
- whether the bug is repeatable