.. -*- coding: utf-8 -*-

.. _LDAC_useful:

==========================
 LDAC - Some Useful Tasks
==========================

.. note::
   The concrete examples on this page use the LDAC catalogue 
   `D1_r_sex.cat <../_static/D1_r_sex.cat>`_ and the shell script
   `make_make_ssc_conf <../_static/make_make_ssc_conf>`_. 

   A tar archive with the complete set of LDAC Tools example files
   is `here <../_static/LDAC_Tools_Examples.tgz>`_

This page contains hints on some small and useful tasks when working
with the LDAC tools.

The automatic creation of a configuration file for :command:`make_ssc`
======================================================================

When creating a merged catalogue with :ref:`make_ssc <LDAC_make_ssc>`
after object association with :ref:`associate <LDAC_associate>` one
oftern wants to transfer *all* keys from an input catalogue to the
merged one. The :command:`bash` shell script `make_make_ssc_conf
<../_static/make_make_ssc_conf>`_ can help with the tedious task of
creating the configuration file for :ref:`make_ssc <LDAC_make_ssc>`:
::

  user$ make_make_ssc_conf
  Usage ./make_make_ssc_conf -i <cat> [-t table (OBJECTS)] [-c channel (ALL)] [-m merge (AVE_REG)]

  user$ make_make_ssc_conf -i D1_r_sex.cat -t LDAC_OBJECTS -c 0
  COL_NAME=X_IMAGE
  COL_INPUT=X_IMAGE
  COL_CHAN=0
  COL_MERGE=AVE_REG
  #
  COL_NAME=Y_IMAGE
  COL_INPUT=Y_IMAGE
  COL_CHAN=0
  COL_MERGE=AVE_REG
  #
  COL_NAME=A_IMAGE
  COL_INPUT=A_IMAGE
  COL_CHAN=0
  COL_MERGE=AVE_REG
  #
 
  .
  .

Typically the output of :command:`make_make_ssc_conf` only needs to be edited
slightly (if at all) before it can be used with :command:`make_ssc`.