CameraSys.h

Go to the documentation of this file.

/* 
 * LSST Data Management System
 * Copyright 2014 LSST Corporation.
 * 
 * This product includes software developed by the
 * LSST Project (http://www.lsst.org/).
 *
 * 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 3 of the License, or
 * (at your option) any later version.
 * 
 * This program 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 LSST License Statement and 
 * the GNU General Public License along with this program.  If not, 
 * see <http://www.lsstcorp.org/LegalNotices/>.
 */

#if !defined(LSST_AFW_CAMERAGEOM_CAMERASYS_H)
#define LSST_AFW_CAMERAGEOM_CAMERASYS_H

#include <functional>
#include <string>
#include <ostream>
#include <sstream>
#include "lsst/afw/geom/TransformMap.h"
#include "lsst/afw/geom/TransformMapImpl.h"

namespace lsst {
namespace afw {
namespace cameraGeom {

class CameraSysPrefix {
public:
    explicit CameraSysPrefix(
        std::string const &sysName  
    ) : _sysName(sysName) {}

    std::string getSysName() const { return _sysName; };

    bool operator==(CameraSysPrefix const &rhs) const {
        return _sysName == rhs.getSysName();
    }

    bool operator!=(CameraSysPrefix const &rhs) const {
        return !(*this == rhs);
    }
private:
    std::string _sysName;   
};

class CameraSys {
public:
    explicit CameraSys(
        std::string const &sysName,         
        std::string const &detectorName=""  
    ) : _sysName(sysName), _detectorName(detectorName) {};

    explicit CameraSys(
        CameraSysPrefix const &sysPrefix,   
        std::string const &detectorName=""  
    ) : _sysName(sysPrefix.getSysName()), _detectorName(detectorName) {};

    CameraSys() : _sysName("?"), _detectorName() {};

    std::string getSysName() const { return _sysName; };

    std::string getDetectorName() const { return _detectorName; };

    bool hasDetectorName() const { return !_detectorName.empty(); }

    bool operator==(CameraSys const &rhs) const {
        return _sysName == rhs.getSysName() && _detectorName == rhs.getDetectorName();
    }

    bool operator!=(CameraSys const &rhs) const {
        return !(*this == rhs);
    }

    // less-than operator required for use in std::map
    bool operator<(CameraSys const &rhs) const {
        if (_sysName == rhs.getSysName()) {
            return _detectorName < rhs.getDetectorName();
        } else {
            return _sysName < rhs.getSysName();
        }
    }

private:
    std::string _sysName;       
    std::string _detectorName;  
};

// CameraSys is intended as a key for geom::TransformMap, so define this useful type
typedef geom::TransformMap<CameraSys> CameraTransformMap;

// *** Standard camera coordinate systems ***

extern CameraSys const FOCAL_PLANE;

extern CameraSys const PUPIL;

extern CameraSysPrefix const PIXELS;

extern CameraSysPrefix const TAN_PIXELS;

extern CameraSysPrefix const ACTUAL_PIXELS;

std::ostream &operator<< (std::ostream &os, CameraSysPrefix const &detSysPrefix);

std::ostream &operator<< (std::ostream &os, CameraSys const &cameraSys);

}}}

#endif