lsst.jointcal  21.0.0-8-ga5967ee+492d3f0d3a
Associations.cc
Go to the documentation of this file.
1 // -*- LSST-C++ -*-
2 /*
3  * This file is part of jointcal.
4  *
5  * Developed for the LSST Data Management System.
6  * This product includes software developed by the LSST Project
7  * (https://www.lsst.org).
8  * See the COPYRIGHT file at the top-level directory of this distribution
9  * for details of code ownership.
10  *
11  * This program is free software: you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation, either version 3 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program. If not, see <https://www.gnu.org/licenses/>.
23  */
24 
25 #include <cmath>
26 #include <iostream>
27 #include <limits>
28 #include <sstream>
29 
30 #include "lsst/log/Log.h"
32 #include "lsst/jointcal/CcdImage.h"
35 #include "lsst/jointcal/Frame.h"
36 #include "lsst/jointcal/FatPoint.h"
39 
40 #include "lsst/afw/image/Image.h"
43 
44 #include "lsst/pex/exceptions.h"
45 #include "lsst/geom/Box.h"
46 #include "lsst/geom/Point.h"
47 #include "lsst/afw/image/Calib.h"
48 
49 #include "lsst/sphgeom/LonLat.h"
50 #include "lsst/sphgeom/Circle.h"
52 
53 namespace jointcal = lsst::jointcal;
54 
55 namespace {
56 LOG_LOGGER _log = LOG_GET("jointcal.Associations");
57 }
58 
59 namespace lsst {
60 namespace jointcal {
61 
65  lsst::geom::Box2I const &bbox, std::string const &filter,
67  std::shared_ptr<afw::cameraGeom::Detector> detector, int visit, int ccd,
68  lsst::jointcal::JointcalControl const &control) {
69  auto ccdImage = std::make_shared<CcdImage>(catalog, wcs, visitInfo, bbox, filter, photoCalib, detector,
70  visit, ccd, control.sourceFluxField);
71  ccdImageList.push_back(ccdImage);
72  LOGLS_DEBUG(_log, "Catalog " << ccdImage->getName() << " has " << ccdImage->getWholeCatalog().size()
73  << " objects.");
74 }
75 
78  centers.reserve(ccdImageList.size());
79  for (auto const &ccdImage : ccdImageList) {
80  centers.push_back(ccdImage->getBoresightRaDec());
81  }
82  auto commonTangentPoint = geom::averageSpherePoint(centers);
83  LOGLS_DEBUG(_log, "Using common tangent point: " << commonTangentPoint.getPosition(geom::degrees));
84  setCommonTangentPoint(commonTangentPoint.getPosition(geom::degrees));
85 }
86 
88  _commonTangentPoint = Point(commonTangentPoint.getX(), commonTangentPoint.getY()); // a jointcal::Point
89  for (auto &ccdImage : ccdImageList) ccdImage->setCommonTangentPoint(_commonTangentPoint);
90 }
91 
93  // Compute the frame on the common tangent plane that contains all input images.
94  Frame tangentPlaneFrame;
95 
96  for (auto const &ccdImage : ccdImageList) {
97  Frame CTPFrame = ccdImage->getPixelToCommonTangentPlane()->apply(ccdImage->getImageFrame(), false);
98  if (tangentPlaneFrame.getArea() == 0)
99  tangentPlaneFrame = CTPFrame;
100  else
101  tangentPlaneFrame += CTPFrame;
102  }
103 
104  // Convert tangent plane coordinates to RaDec.
105  AstrometryTransformLinear identity;
106  TanPixelToRaDec commonTangentPlaneToRaDec(identity, _commonTangentPoint);
107  Frame raDecFrame = commonTangentPlaneToRaDec.apply(tangentPlaneFrame, false);
108 
110  points.reserve(4);
111  // raDecFrame is in on-sky (RA,Dec) degrees stored as an x/y box:
112  // the on-sky bounding box it represents is given by the corners of that box.
113  points.emplace_back(sphgeom::LonLat::fromDegrees(raDecFrame.xMin, raDecFrame.yMin));
114  points.emplace_back(sphgeom::LonLat::fromDegrees(raDecFrame.xMax, raDecFrame.yMin));
115  points.emplace_back(sphgeom::LonLat::fromDegrees(raDecFrame.xMin, raDecFrame.yMax));
116  points.emplace_back(sphgeom::LonLat::fromDegrees(raDecFrame.xMax, raDecFrame.yMax));
117 
119 }
120 
121 void Associations::associateCatalogs(const double matchCutInArcSec, const bool useFittedList,
122  const bool enlargeFittedList) {
123  // clear reference stars
124  refStarList.clear();
125 
126  // clear measurement counts and associations to refstars, but keep fittedStars themselves.
127  for (auto &item : fittedStarList) {
128  item->clearBeforeAssoc();
129  }
130  // clear fitted stars
131  if (!useFittedList) fittedStarList.clear();
132 
133  for (auto &ccdImage : ccdImageList) {
134  std::shared_ptr<AstrometryTransform> toCommonTangentPlane = ccdImage->getPixelToCommonTangentPlane();
135 
136  // Clear the catalog to fit and copy the whole catalog into it.
137  // This allows reassociating from scratch after a fit.
138  ccdImage->resetCatalogForFit();
139  MeasuredStarList &catalog = ccdImage->getCatalogForFit();
140 
141  // Associate with previous lists.
142  /* To speed up the match (more precisely the contruction of the FastFinder), select in the
143  fittedStarList the objects that are within reach of the current ccdImage */
144  Frame ccdImageFrameCPT = toCommonTangentPlane->apply(ccdImage->getImageFrame(), false);
145  ccdImageFrameCPT = ccdImageFrameCPT.rescale(1.10); // add 10 % margin.
146  // We cannot use FittedStarList::ExtractInFrame, because it does an actual copy, which we don't want
147  // here: we want the pointers in the StarMatch to refer to fittedStarList elements.
148  FittedStarList toMatch;
149 
150  for (auto const &fittedStar : fittedStarList) {
151  if (ccdImageFrameCPT.inFrame(*fittedStar)) {
152  toMatch.push_back(fittedStar);
153  }
154  }
155 
156  // divide by 3600 because coordinates in CTP are in degrees.
157  auto starMatchList = listMatchCollect(Measured2Base(catalog), Fitted2Base(toMatch),
158  toCommonTangentPlane.get(), matchCutInArcSec / 3600.);
159 
160  /* should check what this removeAmbiguities does... */
161  LOGLS_DEBUG(_log, "Measured-to-Fitted matches before removing ambiguities " << starMatchList->size());
162  starMatchList->removeAmbiguities(*toCommonTangentPlane);
163  LOGLS_DEBUG(_log, "Measured-to-Fitted matches after removing ambiguities " << starMatchList->size());
164 
165  // Associate MeasuredStar -> FittedStar using the surviving matches.
166 
167  int matchedCount = 0;
168  for (auto const &starMatch : *starMatchList) {
169  auto bs = starMatch.s1;
170  auto ms_const = std::dynamic_pointer_cast<const MeasuredStar>(bs);
171  auto ms = std::const_pointer_cast<MeasuredStar>(ms_const);
172  auto bs2 = starMatch.s2;
173  auto fs_const = std::dynamic_pointer_cast<const FittedStar>(bs2);
174  auto fs = std::const_pointer_cast<FittedStar>(fs_const);
175  ms->setFittedStar(fs);
176  matchedCount++;
177  }
178  LOGLS_INFO(_log, "Matched " << matchedCount << " objects in " << ccdImage->getName());
179 
180  // add unmatched objets to FittedStarList
181  int unMatchedCount = 0;
182  for (auto const &mstar : catalog) {
183  // to check if it was matched, just check if it has a fittedStar Pointer assigned
184  if (mstar->getFittedStar()) continue;
185  if (enlargeFittedList) {
186  auto fs = std::make_shared<FittedStar>(*mstar);
187  // transform coordinates to CommonTangentPlane
188  toCommonTangentPlane->transformPosAndErrors(*fs, *fs);
190  mstar->setFittedStar(fs);
191  }
192  unMatchedCount++;
193  }
194  LOGLS_INFO(_log, "Unmatched objects: " << unMatchedCount);
195  } // end of loop on CcdImages
196 
197  // !!!!!!!!!!!!!!!!!
198  // TODO: DO WE REALLY NEED THIS???
199  // Why do we need to do this, instead of directly computing them in normalizeFittedStars?
200  // What makes the magnitudes special here?
201  // !!!!!!!!!!!!!!!!!
202  // assignMags();
203 }
204 
206  std::string const &fluxField, float refCoordinateErr,
207  bool rejectBadFluxes) {
208  if (refCat.size() == 0) {
210  " reference catalog is empty : stop here "));
211  }
212 
213  afw::table::CoordKey coordKey = refCat.getSchema()["coord"];
214  // Handle reference catalogs that don't have position errors.
215  afw::table::Key<float> raErrKey;
216  afw::table::Key<float> decErrKey;
217  if (std::isnan(refCoordinateErr)) {
218  raErrKey = refCat.getSchema()["coord_raErr"];
219  decErrKey = refCat.getSchema()["coord_decErr"];
220  }
221 
222  auto fluxKey = refCat.getSchema().find<double>(fluxField).key;
223  // Handle reference catalogs that don't have flux errors.
224  afw::table::Key<double> fluxErrKey;
225  try {
226  fluxErrKey = refCat.getSchema().find<double>(fluxField + "Err").key;
227  } catch (pex::exceptions::NotFoundError &) {
228  LOGLS_WARN(_log, "Flux error field ("
229  << fluxField << "Err"
230  << ") not found in reference catalog. Not using ref flux errors.");
231  }
232 
233  refStarList.clear();
234  for (size_t i = 0; i < refCat.size(); i++) {
235  auto const &record = refCat.get(i);
236 
237  auto coord = record->get(coordKey);
238  double flux = record->get(fluxKey);
239  double fluxErr;
240  if (fluxErrKey.isValid()) {
241  fluxErr = record->get(fluxErrKey);
242  } else {
244  }
245  double ra = lsst::geom::radToDeg(coord.getLongitude());
246  double dec = lsst::geom::radToDeg(coord.getLatitude());
247  auto star = std::make_shared<RefStar>(ra, dec, flux, fluxErr);
248 
249  if (std::isnan(refCoordinateErr)) {
250  // refcat errors are unitless but stored as radians: convert to deg**2
251  star->vx = std::pow(lsst::geom::radToDeg(record->get(raErrKey)), 2);
252  star->vy = std::pow(lsst::geom::radToDeg(record->get(decErrKey)), 2);
253  } else {
254  // Convert the fake errors from mas to deg**2
255  star->vx = std::pow(refCoordinateErr / 1000. / 3600. / std::cos(coord.getLatitude()), 2);
256  star->vy = std::pow(refCoordinateErr / 1000. / 3600., 2);
257  }
258  // TODO: cook up a covariance as none of our current refcats have it
259  star->vxy = 0.;
260 
261  // Reject sources with non-finite fluxes and flux errors, and fluxErr=0 (which gives chi2=inf).
262  if (rejectBadFluxes && (!std::isfinite(flux) || !std::isfinite(fluxErr) || fluxErr <= 0)) continue;
263  refStarList.push_back(star);
264  }
265 
266  // project on CTP (i.e. RaDec2CTP), in degrees
267  AstrometryTransformLinear identity;
268  TanRaDecToPixel raDecToCommonTangentPlane(identity, _commonTangentPoint);
269 
270  associateRefStars(matchCut.asArcseconds(), &raDecToCommonTangentPlane);
271 }
272 
273 void Associations::associateRefStars(double matchCutInArcSec, const AstrometryTransform *transform) {
274  // associate with FittedStars
275  // 3600 because coordinates are in degrees (in CTP).
276  auto starMatchList = listMatchCollect(Ref2Base(refStarList), Fitted2Base(fittedStarList), transform,
277  matchCutInArcSec / 3600.);
278 
279  LOGLS_DEBUG(_log, "Refcat matches before removing ambiguities " << starMatchList->size());
280  starMatchList->removeAmbiguities(*transform);
281  LOGLS_DEBUG(_log, "Refcat matches after removing ambiguities " << starMatchList->size());
282 
283  // actually associate things
284  for (auto const &starMatch : *starMatchList) {
285  const BaseStar &bs = *starMatch.s1;
286  const RefStar &rs_const = dynamic_cast<const RefStar &>(bs);
287  RefStar &rs = const_cast<RefStar &>(rs_const);
288  const BaseStar &bs2 = *starMatch.s2;
289  const FittedStar &fs_const = dynamic_cast<const FittedStar &>(bs2);
290  FittedStar &fs = const_cast<FittedStar &>(fs_const);
291  // rs->setFittedStar(*fs);
292  fs.setRefStar(&rs);
293  }
294 
295  LOGLS_INFO(_log,
296  "Associated " << starMatchList->size() << " reference stars among " << refStarList.size());
297 }
298 
299 void Associations::prepareFittedStars(int minMeasurements) {
300  selectFittedStars(minMeasurements);
301  normalizeFittedStars();
302 }
303 
304 void Associations::selectFittedStars(int minMeasurements) {
305  LOGLS_INFO(_log, "Fitted stars before measurement # cut: " << fittedStarList.size());
306 
307  int totalMeasured = 0, validMeasured = 0;
308 
309  // first pass: remove objects that have less than a certain number of measurements.
310  for (auto const &ccdImage : ccdImageList) {
311  MeasuredStarList &catalog = ccdImage->getCatalogForFit();
312  // Iteration happens internal to the loop, as we may delete measuredStars from catalog.
313  for (MeasuredStarIterator mi = catalog.begin(); mi != catalog.end();) {
314  MeasuredStar &mstar = **mi;
315  ++totalMeasured;
316 
317  auto fittedStar = mstar.getFittedStar();
318  // measuredStar has no fittedStar: move on.
319  if (fittedStar == nullptr) {
320  ++mi;
321  continue;
322  }
323 
324  // keep FittedStars which either have a minimum number of
325  // measurements, or are matched to a RefStar
326  if (!fittedStar->getRefStar() && fittedStar->getMeasurementCount() < minMeasurements) {
327  fittedStar->getMeasurementCount()--;
328  mi = catalog.erase(mi); // mi now points to the next measuredStar.
329  } else {
330  ++validMeasured;
331  ++mi;
332  }
333  } // end loop on objects in catalog
334  } // end loop on catalogs
335 
336  // now FittedStars with less than minMeasurements should have zero measurementCount.
337  for (FittedStarIterator fi = fittedStarList.begin(); fi != fittedStarList.end();) {
338  if ((*fi)->getMeasurementCount() == 0) {
339  fi = fittedStarList.erase(fi);
340  } else {
341  ++fi;
342  }
343  }
344 
345  LOGLS_INFO(_log, "Fitted stars after measurement # cut: " << fittedStarList.size());
346  LOGLS_INFO(_log, "Total, valid number of Measured stars: " << totalMeasured << ", " << validMeasured);
347 }
348 
349 void Associations::normalizeFittedStars() const {
350  // Clear positions in order to take the average of the measuredStars.
351  for (auto &fittedStar : fittedStarList) {
352  fittedStar->x = 0.0;
353  fittedStar->y = 0.0;
354  fittedStar->setFlux(0.0);
355  fittedStar->getMag() = 0.0;
356  }
357 
358  // Iterate over measuredStars to add their values into their fittedStars
359  for (auto const &ccdImage : ccdImageList) {
360  std::shared_ptr<AstrometryTransform> toCommonTangentPlane = ccdImage->getPixelToCommonTangentPlane();
361  MeasuredStarList &catalog = ccdImage->getCatalogForFit();
362  for (auto &mi : catalog) {
363  auto fittedStar = mi->getFittedStar();
364  if (fittedStar == nullptr)
365  throw(LSST_EXCEPT(
366  pex::exceptions::RuntimeError,
367  "All measuredStars must have a fittedStar: did you call selectFittedStars()?"));
368  auto point = toCommonTangentPlane->apply(*mi);
369  fittedStar->x += point.x;
370  fittedStar->y += point.y;
371  fittedStar->getFlux() += mi->getFlux();
372  }
373  }
374 
375  for (auto &fi : fittedStarList) {
376  auto measurementCount = fi->getMeasurementCount();
377  fi->x /= measurementCount;
378  fi->y /= measurementCount;
379  fi->getFlux() /= measurementCount;
380  fi->getMag() = utils::nanojanskyToABMagnitude(fi->getFlux());
381  }
382 }
383 
384 void Associations::assignMags() {
385  for (auto const &ccdImage : ccdImageList) {
386  MeasuredStarList &catalog = ccdImage->getCatalogForFit();
387  for (auto const &mstar : catalog) {
388  auto fstar = mstar->getFittedStar();
389  if (!fstar) continue;
390  fstar->addMagMeasurement(mstar->getMag(), mstar->getMagWeight());
391  }
392  }
393 }
394 
396  // By default, Associations::fittedStarList is expressed on the Associations::commonTangentPlane.
397  // For AstrometryFit, we need it on the sky.
399  LOGLS_WARN(_log,
400  "DeprojectFittedStars: Fitted stars are already in sidereal coordinates, nothing done ");
401  return;
402  }
403 
407 }
408 
411  return item->getCatalogForFit().size() > 0;
412  });
413 }
414 
416  size_t count = 0;
417  for (auto const &fittedStar : fittedStarList) {
418  if ((fittedStar != nullptr) & (fittedStar->getRefStar() != nullptr)) count++;
419  }
420  return count;
421 }
422 
423 #ifdef TODO
424 void Associations::collectMCStars(int realization) {
425  CcdImageIterator I;
426  StarMatchIterator smI;
427 
428  for (I = ccdImageList.begin(); I != ccdImageList.end(); I++) {
429  CcdImage &ccdImage = **I;
430  string dbimdir = ccdImage.Dir();
431  string mctruth = dbimdir + "/mc/mctruth.list";
432 
433  if (realization >= 0) {
434  stringstream sstrm;
435  sstrm << dbimdir << "/mc/mctruth_" << realization << ".list";
436  mctruth = sstrm.str();
437  }
438 
439  AstrometryTransformIdentity gti;
440  MeasuredStarList &catalog = ccdImage.getCatalogForFit();
441 
442  // BaseStarWithErrorList mctruthlist(mctruth);
443  DicStarList mctruthlist(mctruth);
444  auto starMatchList =
445  listMatchCollect(Measured2Base(catalog), Dic2Base(mctruthlist), &gti, 1. /* pixel ? */);
446  if (starMatchList)
447  for (smI = starMatchList->begin(); smI != starMatchList->end(); smI++) {
448  StarMatch &sm = *smI;
449  BaseStar *bs = sm.s1;
450  MeasuredStar *mstar = dynamic_cast<MeasuredStar *>(bs);
451  bs = sm.s2;
452  DicStar *dstar = dynamic_cast<DicStar *>(bs);
453  std::unique_ptr<BaseStarWithError> mcstar(new BaseStarWithError(*bs));
454  mcstar->GetMCInfo().iflux = dstar->getval("iflux");
455  mcstar->GetMCInfo().tflux = dstar->getval("sflux");
456  /*
457  mstar->SetMCTruth(mcstar);
458  mstar->SetMCMeas(mcstar);
459  */
460  }
461  else
462  LOGLS_FATAL(_log, "CollectMCStars Unable to match MCTruth w/ catalog!");
463  }
464 }
465 
466 void Associations::setFittedStarColors(std::string dicStarListName, std::string color,
467  double matchCutArcSec) {
468  // decode color string in case it is x-y
469  size_t pos_minus = color.find('-');
470  bool compute_diff = (pos_minus != string::npos);
471  std::string c1, c2;
472  c1 = color.substr(0, pos_minus); // if pos_minus == npos, means "up to the end"
473  if (compute_diff) c2 = color.substr(pos_minus + 1, string::npos);
474  DicStarList cList(dicStarListName);
475  if (!cList.HasKey(c1))
476  throw(GastroException("Associations::SetFittedstarColors : " + dicStarListName +
477  " misses a key named \"" + c1 + "\""));
478  if (compute_diff && !cList.HasKey(c2))
479  throw(GastroException("Associations::SetFittedstarColors : " + dicStarListName +
480  " misses a key named \"" + c2 + "\""));
481  // we associate in some tangent plane. The reference catalog is expressed on the sky,
482  // but FittedStar's may be still in this tangent plane.
484  AstrometryTransformIdentity id;
485  TanRaDecToPixel proj(AstrometryTransformLinear(), getCommonTangentPoint());
486  // project or not ?
487  AstrometryTransform *id_or_proj = &proj;
488  if (fittedStarList.inTangentPlaneCoordinates) id_or_proj = &id;
489  // The color List is to be projected:
490  TStarList projected_cList((BaseStarList &)cList, proj);
491  // Associate
492  auto starMatchList = listMatchCollect(Fitted2Base(fittedStarList), (const BaseStarList &)projected_cList,
493  id_or_proj, matchCutArcSec / 3600);
494 
495  LOGLS_INFO(_log, "Matched " << starMatchList->size() << '/' << fittedStarList.size()
496  << " FittedStars to color catalog");
497  // Evaluate and assign colors.
498  for (auto i = starMatchList->begin(); i != starMatchList->end(); ++i) {
499  BaseStar *s1 = i->s1;
500  FittedStar *fs = dynamic_cast<FittedStar *>(s1);
501  BaseStar *s2 = i->s2;
502  const TStar *ts = dynamic_cast<const TStar *>(s2);
503  const DicStar *ds = dynamic_cast<const DicStar *>(ts->get_original());
504  fs->color = ds->getval(c1);
505  if (compute_diff) fs->color -= ds->getval(c2);
506  }
507 }
508 
509 #endif /* TODO */
510 } // namespace jointcal
511 } // namespace lsst
AmpInfoBoxKey bbox
table::Key< int > id
table::Key< int > detector
#define LSST_EXCEPT(type,...)
Combinatorial searches for linear transformations to go from list1 to list2.
#define LOGLS_WARN(logger, message)
#define LOGLS_FATAL(logger, message)
#define LOG_GET(logger)
#define LOGLS_INFO(logger, message)
#define LOGLS_DEBUG(logger, message)
double dec
Key< U > key
table::Key< table::Array< std::uint8_t > > wcs
pairs of points
T begin(T... args)
std::shared_ptr< RecordT > const get(size_type i) const
SchemaItem< T > find(std::string const &name) const
constexpr double asArcseconds() const noexcept
size_t nFittedStarsWithAssociatedRefStar() const
Return the number of fittedStars that have an associated refStar.
void computeCommonTangentPoint()
Sets a shared tangent point for all ccdImages, using the mean of the centers of all ccdImages.
Definition: Associations.cc:76
lsst::sphgeom::Circle computeBoundingCircle() const
Return the bounding circle in on-sky (RA, Dec) coordinates containing all CcdImages.
Definition: Associations.cc:92
int nCcdImagesValidForFit() const
return the number of CcdImages with non-empty catalogs to-be-fit.
void createCcdImage(afw::table::SourceCatalog &catalog, std::shared_ptr< lsst::afw::geom::SkyWcs > wcs, std::shared_ptr< lsst::afw::image::VisitInfo > visitInfo, lsst::geom::Box2I const &bbox, std::string const &filter, std::shared_ptr< afw::image::PhotoCalib > photoCalib, std::shared_ptr< afw::cameraGeom::Detector > detector, int visit, int ccd, lsst::jointcal::JointcalControl const &control)
Create a ccdImage from an exposure catalog and metadata, and add it to the list.
Definition: Associations.cc:62
void setCommonTangentPoint(lsst::geom::Point2D const &commonTangentPoint)
Sets a shared tangent point for all ccdImages.
Definition: Associations.cc:87
void associateCatalogs(const double matchCutInArcsec=0, const bool useFittedList=false, const bool enlargeFittedList=true)
incrementaly builds a merged catalog of all image catalogs
Point getCommonTangentPoint() const
can be used to project sidereal coordinates related to the image set on a plane.
Definition: Associations.h:105
void collectRefStars(afw::table::SimpleCatalog &refCat, geom::Angle matchCut, std::string const &fluxField, float refCoordinateErr, bool rejectBadFluxes=false)
Collect stars from an external reference catalog and associate them with fittedStars.
FittedStarList fittedStarList
Definition: Associations.h:58
void prepareFittedStars(int minMeasurements)
Set the color field of FittedStar 's from a colored catalog.
void deprojectFittedStars()
Sends back the fitted stars coordinates on the sky FittedStarsList::inTangentPlaneCoordinates keeps t...
a virtual (interface) class for geometric transformations.
implements the linear transformations (6 real coefficients).
The base class for handling stars. Used by all matching routines.
Definition: BaseStar.h:50
double getMag() const
Definition: BaseStar.h:103
Handler of an actual image from a single CCD.
Definition: CcdImage.h:64
MeasuredStarList const & getCatalogForFit() const
Gets the catalog to be used for fitting, which may have been cleaned-up.
Definition: CcdImage.h:94
The objects which have been measured several times.
Definition: FittedStar.h:61
void setRefStar(const RefStar *_refStar)
Set the astrometric reference star associated with this star.
Definition: FittedStar.cc:46
A list of FittedStar s. Such a list is typically constructed by Associations.
Definition: FittedStar.h:123
rectangle with sides parallel to axes.
Definition: Frame.h:38
Frame rescale(const double factor) const
rescale it. The center does not move.
Definition: Frame.cc:110
bool inFrame(double x, double y) const
inside?
Definition: Frame.cc:120
double xMin
coordinate of boundary.
Definition: Frame.h:41
double getArea() const
Definition: Frame.cc:118
objects measured on actual images.
Definition: MeasuredStar.h:46
std::shared_ptr< FittedStar > getFittedStar() const
Definition: MeasuredStar.h:113
double getMagWeight() const
the inverse of the mag variance
Definition: MeasuredStar.h:106
A list of MeasuredStar. They are usually filled in Associations::createCcdImage.
Definition: MeasuredStar.h:146
A point in a plane.
Definition: Point.h:36
Objects used as position anchors, typically USNO stars.
Definition: RefStar.h:39
void applyTransform(const Operator &op)
enables to apply a geometrical transform if Star is Basestar or derives from it.
Definition: StarList.h:98
The transformation that handles pixels to sideral transformations (Gnomonic, possibly with polynomial...
virtual void apply(const double xIn, const double yIn, double &xOut, double &yOut) const=0
This one is the Tangent Plane (called gnomonic) projection (from celestial sphere to tangent plane)
static ConvexPolygon convexHull(std::vector< UnitVector3d > const &points)
Circle getBoundingCircle() const override
T clear(T... args)
T cos(T... args)
T count_if(T... args)
T emplace_back(T... args)
T end(T... args)
T erase(T... args)
T find(T... args)
T get(T... args)
T isfinite(T... args)
T isnan(T... args)
SpherePoint averageSpherePoint(std::vector< SpherePoint > const &coords)
constexpr AngleUnit degrees
constexpr double radToDeg(double x) noexcept
StarList< BaseStar > BaseStarList
Definition: BaseStar.h:119
BaseStarList & Measured2Base(MeasuredStarList &This)
Definition: MeasuredStar.cc:58
std::unique_ptr< StarMatchList > listMatchCollect(const BaseStarList &list1, const BaseStarList &list2, const AstrometryTransform *guess, const double maxDist)
assembles star matches.
Definition: ListMatch.cc:569
BaseStarList & Fitted2Base(FittedStarList &This)
Definition: FittedStar.cc:64
MeasuredStarList::iterator MeasuredStarIterator
Definition: MeasuredStar.h:154
::std::list< StarMatch >::iterator StarMatchIterator
Definition: StarMatch.h:133
BaseStarList & Ref2Base(RefStarList &This)
Definition: RefStar.cc:34
FittedStarList::iterator FittedStarIterator
Definition: FittedStar.h:132
double nanojanskyToABMagnitude(double flux)
Class for a simple mapping implementing a generic AstrometryTransform.
T pow(T... args)
T push_back(T... args)
T quiet_NaN(T... args)
T reserve(T... args)
T size(T... args)
T str(T... args)
std::string sourceFluxField
"name of flux field in source catalog" ;
T substr(T... args)
Key< int > visitInfo
Key< int > photoCalib