source: trunk/src/Detection/sorting.cc @ 848

// -----------------------------------------------------------------------
// sorting.cc: Sort the list of Detections by channel or velocity.
// -----------------------------------------------------------------------
// Copyright (C) 2006, Matthew Whiting, ATNF
//
// This program is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the
// Free Software Foundation; either version 2 of the License, or (at your
// option) any later version.
//
// Duchamp is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
// for more details.
//
// You should have received a copy of the GNU General Public License
// along with Duchamp; if not, write to the Free Software Foundation,
// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
//
// Correspondence concerning Duchamp may be directed to:
//    Internet email: Matthew.Whiting [at] atnf.csiro.au
//    Postal address: Dr. Matthew Whiting
//                    Australia Telescope National Facility, CSIRO
//                    PO Box 76
//                    Epping NSW 1710
//                    AUSTRALIA
// -----------------------------------------------------------------------
#include <iostream>
#include <sstream>
#include <vector>
#include <algorithm>
#include <duchamp/duchamp.hh>
#include <duchamp/param.hh>
#include <duchamp/Detection/detection.hh>


/// @brief
/// A class to match things pair-wise (useful for sorting).
/// 
/// @details This class is deigned to match two quantities to each
/// other.  It was devised to find a way of taking a pair of lists
/// that are matched, and sorting one list while keeping the second
/// matched pair-wise.
/// 
/// The elements are currently just assumed to be floats. This could be
/// extended by templating, but at this stage we don't need to...
class Pair
{
public:
  Pair(){};
  virtual ~Pair(){};
  friend bool operator< (const Pair& lhs, const Pair& rhs){
    ///  A comparison operator for pairs.  Compare the primary elements
    ///  of the two pairs, using the basic < operator.
    return (lhs.primary < rhs.primary);
  };
  void define(float p, float m){
    /// Basic assignment function.
    primary=p; matching=m;
  };
  float get1(){return primary;};
  float get2(){return matching;};
private:
  float primary;  ///< The main element -- this will be the one that
                  ///can be compared.
  float matching; ///< The secondary element -- this cannot be
                  ///compared with other objects, it just tracks the
                  ///primary.
};

//======================================================================

namespace duchamp
{

  void SortByZ(std::vector <Detection> &inputList)
  {
    /// A Function that takes a list of Detections and sorts them in
    /// order of increasing z-pixel value.  Upon return, the inputList
    /// is sorted.
    /// 
    /// We use the std::stable_sort function, so that the order of
    /// objects with the same z-value is preserved.
    /// \param inputList List of Detections to be sorted.
    /// \return The inputList is returned with the elements sorted.

    long size = inputList.size();
    Pair *info = new Pair[size];
  
    for(int i=0;i<size;i++) info[i].define(inputList[i].getZcentre(), float(i));

    std::stable_sort(info,info+size);
  
    std::vector <Detection> sorted;
    for(int i=0;i<size;i++) sorted.push_back( inputList[int(info[i].get2())] );

    delete [] info;

    inputList.clear();
    for(int i=0;i<size;i++) inputList.push_back( sorted[i] );
    sorted.clear();
  
  }

  //======================================================================

  void SortByVel(std::vector <Detection> &inputList)
  {
    /// @details
    /// A Function that takes a list of Detections and sorts them in 
    ///  order of increasing velocity.
    /// Every member of the vector needs to have WCS defined, (and if so,
    ///   then vel is assumed to be defined for all), otherwise no sorting
    ///   is done.
    /// 
    /// We use the std::stable_sort function, so that the order of
    /// objects with the same z-value is preserved.
    /// 
    /// \param inputList List of Detections to be sorted.
    /// \return The inputList is returned with the elements sorted,
    /// unless the WCS is not good for at least one element, in which
    /// case it is returned unaltered.

    bool isGood = true;
    for(size_t i=0;i<inputList.size();i++) isGood = isGood && inputList[i].isWCS();

    if(isGood){

      long size = inputList.size();
      Pair *info = new Pair[size];
    
      for(int i=0;i<size;i++) info[i].define(inputList[i].getVel(), float(i));

      std::stable_sort(info, info+size);
  
      std::vector <Detection> sorted;
      for(int i=0;i<size;i++) sorted.push_back( inputList[int(info[i].get2())] );

      delete [] info;

      inputList.clear();
      for(int i=0;i<size;i++) inputList.push_back( sorted[i] );
      sorted.clear();
  
    }

  }  

  //======================================================================

  void SortDetections(std::vector <Detection> &inputList, std::string parameter)
  {
    /// @details
    /// A Function that takes a list of Detections and sorts them in 
    ///  order of increasing value of the parameter given.
    ///
    /// Every member of the vector needs to have WCS defined, (and if
    /// so, then parameter in question is assumed to be defined for
    /// all), otherwise no sorting is done. The exception is the
    /// z-value, in which case sorting is always done.
    /// 
    /// We use the std::stable_sort function, so that the order of
    /// objects with the same parameter value is preserved.
    /// 
    /// \param inputList List of Detections to be sorted.
    /// \param parameter The name of the parameter to be sorted
    ///        on. Options are "zvalue", "vel", "ra", "dec", "iflux",
    ///        "pflux".
    /// \return The inputList is returned with the elements sorted,
    ///         unless the WCS is not good for at least one element,
    ///         in which case it is returned unaltered.

    bool OK = false;
    for(int i=0;i<numSortingParamOptions;i++) 
      OK = OK || (parameter==sortingParamOptions[i]);
    if(!OK){
      std::stringstream errmsg;
      errmsg << "Invalid sorting parameter: " << parameter << "\nNot doing any sorting.";
      duchampError("SortDetections", errmsg.str());
      return;
    }

    bool isGood = true;
    if(parameter!="zvalue" && parameter!="pflux" && parameter!="snr" && parameter!="xvalue" && parameter!="yvalue"){
      for(size_t i=0;i<inputList.size();i++) isGood = isGood && inputList[i].isWCS();
    }

    if(isGood){

      long size = inputList.size();
      Pair *info = new Pair[size];
    
      for(int i=0;i<size;i++){
        if(parameter=="xvalue")      info[i].define(inputList[i].getXcentre(), float(i));       
        else if(parameter=="yvalue") info[i].define(inputList[i].getYcentre(), float(i));       
        else if(parameter=="zvalue") info[i].define(inputList[i].getZcentre(), float(i));       
        else if(parameter=="ra")     info[i].define(inputList[i].getRA(), float(i));
        else if(parameter=="dec")    info[i].define(inputList[i].getDec(), float(i));
        else if(parameter=="vel")    info[i].define(inputList[i].getVel(), float(i));
        else if(parameter=="w50")    info[i].define(inputList[i].getW50(), float(i));
        else if(parameter=="iflux")  info[i].define(inputList[i].getIntegFlux(), float(i));
        else if(parameter=="pflux")  info[i].define(inputList[i].getPeakFlux(), float(i));
        else if(parameter=="snr")    info[i].define(inputList[i].getPeakSNR(), float(i));
      }

      std::stable_sort(info, info+size);
  
      std::vector <Detection> sorted;
      for(int i=0;i<size;i++) sorted.push_back( inputList[int(info[i].get2())] );

      delete [] info;

      inputList.clear();
      for(int i=0;i<size;i++) inputList.push_back( sorted[i] );
      sorted.clear();
  
    }

  }  

}