XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


rgssources (rgssources-6.3) [xmmsas_20211130_0941-20.0.0]


Upgrading the format.

rgssources is now backward-compatible, ie it can read source lists which were created in the pre-sas-5.1 format. The task attempts to upgrade the format of these older files and in fact can be used to do this exclusively, without the necessity to add to or otherwise modify the source list. The upgrading is performed by a public subroutine called convertOldFiles located in the module rgssources_update.f90. The interface is as follows:

  subroutine convertOldFiles(setName, writeObsKwds, writeExpKwds&
  , instrumentId, expId)

    implicit none 

    character(*),   intent(in)           :: setName
    logical,        intent(in), optional :: writeObsKwds, writeExpKwds
    integer(int32), intent(in), optional :: instrumentId, expId
  end subroutine convertOldFiles

The algorithm is described in section 7.

The upgrade consists of the the following steps:

Notes on the column value conversion:

The prime source is left untouched (although rgssources will fail if its INDEX value does not exist in the file). No other extensions of the source list file are altered or deleted during this upgrade process.

XMM-Newton SOC -- 2021-11-30