alecthomson/sdhdf_tools repository overview

⁠README for the sdhdf_tools repository

⁠About

This repository contains a collection of tools for working with Spectral-Domain Hierarchical Data Format (SDHDF) files.

INSPECTA is an 'INtegrated SDHDF Processing Engine in C for Telescope data Analysis'.

Formerly known as 'sdhdfProc', INSPECTA is a software package to read, manipulate and process radio astronomy data in SDHDF format.

Author: [email protected]⁠

Copyright: CSIRO 2020, 2021, 2022, 2023, 2024

⁠Contents

• containers
• docs
• inspecta

⁠Building INSPECTA

To build INSPECTA, please follow the steps below:

1. Install prerequisites:

Erfa (https://github.com/liberfa/erfa⁠) or the SOFA library (http://www.iausofa.org/⁠)

HDF5 library (https://www.hdfgroup.org/downloads/hdf5⁠)

Pgplot library (http://www.astro.caltech.edu/~tjp/pgplot/⁠)

Calceph library (https://www.imcce.fr/recherche/equipes/asd/calceph/⁠)

Cfitsio library

1. Navigate to the INSPECTA source code directory (inspecta/)

2. Run the bootstrap script:

./bootstrap

1. Run configure with e.g.:

./configure --prefix=/path/to/install CFLAGS=-I/path/to/include LDFLAGS=-L/path/to/lib

Where /path/to/install /path/to/include /path/to/lib are full paths to where you wish to install it, full path to the prerequisite header files, and full path to the prerequisite libraries respectively.

1. Compile it with:

make

1. Install it with:

make install

1. Configure your SDHDF_RUNTIME environmental variable to point to:

inspecta/runtime

⁠Branches

The repository has the following branches available:

• master
• sofa_build

(The master branch requires the ERFA library by default. Checkout the 'sofa_build' branch if you need to use the SOFA library)

• sdhdfv3 Compatible with data written in SDHDF <=v3.0

⁠Test data

Accompanying this repository is the sdhdf_test_data repository:

• https://bitbucket.csiro.au/scm/cpda/sdhdf\_test\_data.git⁠

⁠More information

If you have any comments/queries, contact [email protected]⁠ or [email protected]⁠