Giter Club home page Giter Club logo

miriad's Introduction

MIRIAD

MIRIAD (Multi-channel Image Reconstruction, Image Analysis, and Display) was originally developed for BIMA, and has been adopted and expanded for a number of radio telescopes arrays (CARMA, SMA, WSRT, ATNF and perhaps more). Sadly each of these have cloned and diverged from the original version of MIRIAD. So be it. What you see here is the original BIMA/CARMA version, as originally developed by Bob Sault in the late 80s and was actively used for CARMA until 2015, and is still in some use.

Reference

The original Sault et al. (1995) paper is https://ui.adsabs.harvard.edu/abs/1995ASPC...77..433S where you can also find the bibtex entry:

  @INPROCEEDINGS{1995ASPC...77..433S,
         author = {{Sault}, R.~J. and {Teuben}, P.~J. and {Wright}, M.~C.~H.},
          title = "{A Retrospective View of MIRIAD}",
       keywords = {Astrophysics},
      booktitle = {Astronomical Data Analysis Software and Systems IV},
           year = 1995,
         editor = {{Shaw}, R.~A. and {Payne}, H.~E. and {Hayes}, J.~J.~E.},
         series = {Astronomical Society of the Pacific Conference Series},
         volume = {77},
          month = jan,
          pages = {433},
  archivePrefix = {arXiv},
         eprint = {astro-ph/0612759},
   primaryClass = {astro-ph},
         adsurl = {https://ui.adsabs.harvard.edu/abs/1995ASPC...77..433S},
        adsnote = {Provided by the SAO/NASA Astrophysics Data System}
  }

Installation

We have a csh script install_miriad and a much simpler bare bones install_miriad.sh. They may contain helpful comments to get you past some hurdles, but here are briefly the steps on a linux machine, extracted from those scripts:

  git clone https://github.com/astroumd/miriad
  cd miriad
  install/install.miriad  gfortran=1  generic=1  gif=1  telescope=carma

This installation will take about 5 minutes, and usually takes up 300-400MB.

Requirements

The following tools should be present: a Fortran and C compiler, make, csh, git, development libraries for X11, optionally automake and pgplot library. It is recommended to use the native pgplot, not the pgplot that miriad contains, because the former now supports PNG's.

Ubuntu

Essentials:

  sudo apt install git tcsh build-essential gfortran xorg-dev libreadline6-dev -y

Optionals:

  sudo apt install pgplot5 automake libtool flex -y

Centos

Native pgplot needs a special install. Not tested.

History

  • V1 Original BIMA - Bob Sault (1987-1990)
  • V2 BIMA - RCS based (1990-2000)
  • V3 BIMA and CARMA - CVS based (2001-2003)
  • V4 BIMA and CARMA - 64 bit (2003-2016)
  • V5 - never released -
  • V6 CARMA - github based, pgplot decoupled

miriad's People

Contributors

teuben avatar

Stargazers

 avatar

Watchers

James Cloos avatar  avatar  avatar

Forkers

teuben gui-cui

miriad's Issues

redhat8 and ubuntu22 all broken compilations

software rot in action. gfortran needs the -std=legacy by now, the compiler is getting pretty strict by now. For U22 this is V11.2. On RH8 even gfortran 8.5 is misbehaving.

<rpc/rpc.h> is also missing now.

no doubt more to come.

switching compilers

the scripting interface does not listen well enough to new settings of the CC, CXX and FC variables. There are components in MIRIAD that fall back to gfortran (the default) instead of for example gfortran-12

velocity units incorrect when reading IRAM/gildas FITS into miriad

I have some IRAM cubes created by gildas that I have read into miriad. They appear to have correct headers with velocity units in m/s but when read in with the FITS task, CUNIT3 is interpreted as km/s. For example in the attached FITS file,

CRVAL3 = 25 km/s
CDELT3 = -0.13 km/s
CRPIX3 = 113.4

which would be the correct values for these data. But imhead sees:
crval3 Coordinate value of ref. pixel: 2.5\x10\u4\d
cdelt3 Increment between pixels: -132.8

I tried puthd in=file.fits/CUNIT3='m/s' but that made no difference.

m16_13co10.fits.gz

legacy fortran compiler

some newer systems now need the

 -std=legacy

gfortran compiler flag in order to compile; it had been added to pgplot a while back, but on one new ubuntu system the compile needs this option added to the whole miriad compile.

Greek chars not translated in plots

Probably affects all special chars. Plots show e.g. \l for lambda.
Linux centos 7. Haven't tested other distros.
Try uvplt axis=uc,vc for example.

atlod: compilation error

for the record, on Ubuntu 20 (gfortran version 9.3.0) atlod and associated libraries fail to compile.

On centos7 (gfortran 4.8.5 !!!) is still works.

Compilers get stricter over time....

xyzs2c: Subcube lies outside cube

The standard compile still seems to have a 64bit legacy issue:

     ### Fatal Error [gaufit]:  xyzs2c: Subcube lies outside cube

in the standard test

references to all the other miriad siblings

the readme file should list a URL reference to the other miriad siblings:

  1. CARMA miriad (Peter Teuben) - yes, the original one (Peter Williams maintains a parallel git repo)
  2. SMA miriad (Jun-Hui Zhao) - derived from CARMA
  3. ATNF miriad (Mark Wieringa) - long time split from CARMA
  4. WSRT miriad (Thijs vd Hulst) - derived from ATNF

hopefully there are no more

mac install issues

It remains a problem to install miriad reliably on a mac.

gfortran comes in two flavors (brew and hpc.sourceforge). brew has recently shut out pgplot (licensing issues).

option to use pgplot from the system

The "borrow" version of PGPLOT that MIRIAD comes with is essentially the old (32bit) version that Tim Pearson developed. Since then we fixed a few 64bit issues, but the community version (e.g. ubuntu) has a few new drivers, e.g. png files.
It should be straightforward to make an option to switch the build to use the community version instead.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.