Isis 3.0 Object Programmers' Reference |
Home |
a control network More...
#include <ControlNet.h>
Classes | |
class | ControlMeasureLessThanFunctor |
class | ControlVertex |
Encapsulation of a vertex in a minimum spanning tree. More... | |
Signals | |
void | networkStructureModified () |
Public Member Functions | |
ControlNet () | |
Creates an empty ControlNet object. | |
ControlNet (const ControlNet &other) | |
ControlNet (const QString &filename, Progress *progress=0) | |
Creates a ControlNet object with the given list of control points and cubes. | |
void | ReadControl (const QString &filename, Progress *progress=0) |
Reads in the control points from the given file. | |
void | Write (const QString &filename, bool pvl=false) |
Writes out the control network. | |
void | AddPoint (ControlPoint *point) |
Adds a ControlPoint to the ControlNet. | |
int | DeletePoint (ControlPoint *point) |
Delete a ControlPoint from the network by the point's address. | |
int | DeletePoint (QString pointId) |
Delete a ControlPoint from the network using the point's Id. | |
int | DeletePoint (int index) |
Delete a ControlPoint from the network using the point's index. | |
bool | ContainsPoint (QString pointId) const |
QList< QString > | GetCubeSerials () const |
Use this method to get a complete list of all the cube serial numbers in the network. | |
QList< ControlCubeGraphNode * > | GetCubeGraphNodes () |
QList< QList< QString > > | GetSerialConnections () const |
This method searches through all the cube serial numbers in the network. | |
QList< QList < ControlCubeGraphNode * > > | GetNodeConnections () const |
This method searches through all the cube serial numbers in the network. | |
QSet< ControlMeasure * > | MinimumSpanningTree (QList< ControlCubeGraphNode * > &island, bool lessThan(const ControlMeasure *, const ControlMeasure *)) const |
This method uses Kruskal's Algorithm to construct a minimum spanning tree of the given island, with control measures acting as the edges between graph nodes. | |
int | getEdgeCount () const |
QString | CubeGraphToString () const |
Used for verifying graph intergrity. | |
QList< ControlMeasure * > | GetMeasuresInCube (QString serialNumber) |
Get all the measures pertaining to a given cube serial number. | |
QList< ControlMeasure * > | sortedMeasureList (double(ControlMeasure::*statFunc)() const, double min, double max) |
Get a sorted list of all the measures that have values in a given ragen. | |
void | DeleteMeasuresWithId (QString serialNumber) |
Essentially removes a cube from the networkid. | |
void | ComputeResiduals () |
Compute error for each point in the network. | |
void | ComputeApriori () |
Compute aprior values for each point in the network. | |
const ControlPoint * | GetPoint (QString pointId) const |
ControlPoint * | GetPoint (QString pointId) |
const ControlPoint * | GetPoint (int index) const |
ControlPoint * | GetPoint (int index) |
const ControlCubeGraphNode * | getGraphNode (QString serialNumber) const |
ControlCubeGraphNode * | getGraphNode (QString serialNumber) |
double | AverageResidual () |
Compute the average error of all points in the network. | |
Isis::Camera * | Camera (int index) |
Returns the camera list from the given image number. | |
QString | CreatedDate () const |
Return the Created Date. | |
QString | Description () const |
Return the description of the network. | |
ControlPoint * | FindClosest (QString serialNumber, double sample, double line) |
Finds and returns a pointer to the closest ControlPoint to the ControlMeasure with the given serial number and line sample location. | |
bool | IsValid () const |
Return if the control point is invalid. | |
double | GetMaximumResidual () |
Determine the maximum error of all points in the network. | |
QString | GetNetworkId () const |
int | GetNumEditLockMeasures () |
Return the total number of edit locked measures for all control points in the network. | |
int | GetNumEditLockPoints () |
Returns the number of edit locked control points. | |
int | GetNumIgnoredMeasures () |
Return the total number of ignored measures for all control points in the network. | |
int | GetNumberOfValidMeasuresInImage (const QString &serialNumber) |
Return the number of measures in image specified by serialNumber. | |
int | GetNumberOfJigsawRejectedMeasuresInImage (const QString &serialNumber) |
Return the number of jigsaw rejected measures in image specified by serialNumber. | |
void | ClearJigsawRejected () |
Sets jigsaw rejected flag to false for all points and measures. | |
void | IncrementNumberOfRejectedMeasuresInImage (const QString &serialNumber) |
Increment number of jigsaw rejected measures in image specified by serialNumber. | |
void | DecrementNumberOfRejectedMeasuresInImage (const QString &serialNumber) |
Decrement number of jigsaw rejected measures in image specified by serialNumber. | |
int | GetNumMeasures () const |
Returns the total number of measures for all control points in the network. | |
int | GetNumPoints () const |
Return the number of control points in the network. | |
int | GetNumValidMeasures () |
Return the number of valid (non-ignored) measures for all control points in the network. | |
int | GetNumValidPoints () |
Returns the number of non-ignored control points. | |
QString | GetTarget () const |
Return the target name. | |
QString | GetUserName () const |
Return the user name. | |
QList< ControlPoint * > | GetPoints () |
Return QList of ControlPoints ordered by point ID. | |
QList< QString > | GetPointIds () const |
Return QList of ControlPoint Ids used in hash, in order of addition. | |
std::vector< Distance > | GetTargetRadii () |
Get the target radii. | |
void | SetCreatedDate (const QString &date) |
Set the creation time. | |
void | SetDescription (const QString &newDescription) |
Set the description of the network. | |
void | SetImages (const QString &imageListFile) |
Creates the ControlNet's image cameras based on an input file. | |
void | SetImages (SerialNumberList &list, Progress *progress=0) |
Creates the ControlNet's image camera's based on the list of Serial Numbers. | |
void | SetModifiedDate (const QString &date) |
Set the last modified date. | |
void | SetMutex (QMutex *mutex) |
Set mutex to lock for making Naif calls. | |
void | SetNetworkId (const QString &id) |
Set the network id. | |
void | SetTarget (const QString &target) |
Set the target name. | |
void | SetUserName (const QString &name) |
Set the user name. | |
void | swap (ControlNet &other) |
Swaps the member data with the given control net. | |
ControlNet & | operator= (const ControlNet &other) |
Assign other to this. | |
const ControlPoint * | operator[] (QString id) const |
ControlPoint * | operator[] (QString id) |
const ControlPoint * | operator[] (int id) const |
ControlPoint * | operator[] (int id) |
Private Member Functions | |
void | nullify () |
void | ValidateSerialNumber (QString serialNumber) const |
Does a check to ensure that the given serial number is contained within the network. | |
void | measureAdded (ControlMeasure *measure) |
Updates the ControlCubeGraphNode for the measure's serial number to reflect the addition. | |
void | measureDeleted (ControlMeasure *measure) |
Updates the ControlCubeGraphNode for this measure's serial number to reflect the deletion. | |
void | measureIgnored (ControlMeasure *measure) |
void | measureUnIgnored (ControlMeasure *measure) |
Updates the connections for the ControlCubeGraphNode associated with the measure's serial number to reflect the unignoration. | |
void | UpdatePointReference (ControlPoint *point, QString oldId) |
Updates the key reference (poind Id) from the old one to what the point id was changet to. | |
void | emitNetworkStructureModified () |
QList< ControlCubeGraphNode * > | RandomBFS (QList< ControlCubeGraphNode * > list) const |
Random breadth-first search. | |
void | Shuffle (QList< ControlCubeGraphNode * > &list) const |
Shuffles the QStrings in a QList< QString > | |
QPair< int, int > | CalcBWAndCE (QList< QString > serials) const |
Calculate the band width and critical edges needed by the adjacency matrix that could store cube connectivity if that matrix used the same ordering as is in the provided list. | |
Private Attributes | |
QHash< QString, ControlPoint * > * | points |
hash ControlPoints by ControlPoint Id | |
QHash< QString, ControlCubeGraphNode * > * | cubeGraphNodes |
hash ControlCubeGraphNodes by CubeSerialNumber | |
QStringList * | pointIds |
QMutex * | m_mutex |
QString | p_targetName |
Name of the target. | |
QString | p_networkId |
The Network Id. | |
QString | p_created |
Creation Date. | |
QString | p_modified |
Date Last Modified. | |
QString | p_description |
Textual Description of network. | |
QString | p_userName |
The user who created the network. | |
std::map< QString, Isis::Camera * > | p_cameraMap |
A map from serialnumber to camera. | |
std::map< QString, int > | p_cameraValidMeasuresMap |
A map from serialnumber to #measures. | |
std::map< QString, int > | p_cameraRejectedMeasuresMap |
A map from serialnumber to | |
std::vector< Isis::Camera * > | p_cameraList |
Vector of image number to camera. | |
std::vector< Distance > | p_targetRadii |
Radii of target body. | |
bool | p_invalid |
If the Control Network is currently invalid. | |
Friends | |
class | ControlMeasure |
class | ControlPoint |
a control network
This class is used to store a network of ControlPoints
2005-07-29 Jeff Anderson Original version
2006-01-11 Jacob Danton Updated unitTest
2006-06-22 Brendan George Updated to conform to changes in SerialNumberList class
2008-04-04 Christopher Austin Added Exists function
2008-04-18 Debbie A. Cook Added Progress reports to loading and SetImages and calculates the total number of measurements in the control net
2008-06-18 Christopher Austin Fixed documentation errors
2009-01-06 Jeannie Walldren Fixed typo in SetImages() exception output. Added documentation.
2009-02-05 Christopher Austin when the created date or the modified date are not set, they default to the time in which Write() is called.
2009-04-07 Tracie Sucharski Added NumValidMeasures and NumIgnoredMeasures methods.
2009-06-03 Christopher Austin Added p_invalid functionality along with forceBuild, as well as other small fixes including documentation.
2009-07-13 Stacy Alley The std::vector of ControlPoints called 'p_points' was replaced with a QVector of QString 'p_pointIds' in conjunction with a QHash of <QString, ControlPoint> called 'p_pointsHash'. This was done to speed up the Add method which was essentially slowing down the reading or creation of Control Networks.
2010-05-06 Tracie Sucharski Use defaults of 0. instead of Isis::Null, because 0. is the default in the protocol buffers.
2010-08-06 Tracie Sucharski Updated for changes made after additional working sessions for Control network design.
2009-09-01 Eric Hyer Added two includes: QVector and QString
2010-09-09 Sharmila Prasad Added API to sort Control Net by Point ID Changed PointID's vector to StringList
2009-09-25 Travis Addair Changed methods which return the number of control measures in the network to compute those values at the time the method is called, not when the control network is first initialized.
2010-10-05 Tracie Sucharski Renamed the Write method to WritePvl. Create new method, Write which takes another parameter indicating whether to write pvl format or binary format, The default will write binary.
2010-10-05 Eric Hyer ControlMeasure and ControlPoint now return QStrings for some methods. Fixed breakages caused by this.
2010-10-06 Sharmila Prasad Added method to get CreatedDate
2010-11-21 Tracie Sucharski - Added new keyword, jigsawRejected to the read and write methods.
2011-01-13 Mackenzie Boyd Added copy constructor and assignment operator.
2011-01-17 Eric Hyer - Points are now owned and deleted by the network. Network now stored in such a way that access to all points in a cube is just as cheap as accessing measures in a point. Removed redundant methods and made other api changes.
2011-02-18 Eric Hyer - Made improvements and bug fixes related to interaction to other control network classes including ControlPoint and ControlMesure, but most significantly to ControlCubeGraphNode. Most important fix was network notification of measures added to or removed from points after the point is added to the network.
2011-02-23 Eric Hyer - Added some methods to support graphing calculations (RandomBFS, Shuffle, CalcBWAndCE, and GetNodeConnections).
2011-03-08 Ken Edmundson - Added methods GetNumberOfMeasuresInImage, GetNumberOfJigsawRejectedMeasuresInImage, IncrementNumberOfRejectedMeasuresInImage, DecrementNumberOfRejectedMeasuresInImage, and members p_cameraMeasuresMap and p_cameraRejectedMeasuresMap.
2011-03-12 Debbie A. Cook - Added member p_targetRadii and method GetTargetRadii to support SurfacePoint sigma conversions in ControlPoint.
2011-03-14 Eric Hyer - Cube connection graph now updated when points or measures are ignored.
2011-03-15 Eric Hyer - Some cube graph bugs were fixed.
2011-03-25 Christopher Austin - Added UpdatePointReference() to work with ControlPoint's SetId()
2011-03-29 Steven Lambright - Made versioning viable for first release.
2011-04-27 Steven Lambright - UpdatePointReference had a bug where the pointIds list was not being correctly updated.
2011-05-04 Eric Hyer - References in graph data structure now kept for ignored points and measures
2011-05-25 Eric Hyer - Added getPoints method
2011-06-22 James Alexander Crough and Eric Hyer - Added getGraphNode method.
2011-06-28 Eric Hyer - Added getEdgeCount() method
2011-07-08 Travis Addair - Locked points can no longer be deleted
2011-07-27 Sharmila Prasad - Fixed bug in GetNumEditLockMeasures()
2011-08-01 Eric Hyer - Addressed some graphing issues
2011-08-24 Steven Lambright - Fixed bug in graph code
2011-10-06 Steven Lambright - Having a target is no longer required.
2011-10-14 Ken Edmundson Added method ClearJigsawRejected(); to set all measure/point JigsawRejected flags to false prior to bundle adjustment.
2012-04-13 Orrin Thomas Added method sortedMeasureList, and functor ControlMeasureLessThanFunctor.
2012-11-22 Debbie A. Cook - Changed to use TProjection instead of Projection. References #775.
2012-09-11 Tracie Sucharski - Added a Mutex and MutexLocker for the SetTarget method.
2012-09-26 Steven Lambright - Fixed assignment operator to return a non-const ControlNet reference. Added swap(). Refactored assignment operator to use copy-and-swap idiom which fixed a bug where you couldn't access control points by index after an assignment.
2013-11-08 Tracie Sucharski - Add camera to ignored measures. References #1603.
2013-12-18 Tracie Sucharski - Previous change caused problems for jigsaw app. It was expecting the method GetNumberOfMeasuresInImage to only return the number of VALID (Ignore=False) measures. Renamed method to GetNumberOfValidMeasuresInImage and the private variable p_cameraMeasuresMap to p_cameraValidMeasuresMap. References #1603.
Definition at line 189 of file ControlNet.h.
Isis::ControlNet::ControlNet | ( | ) |
Creates an empty ControlNet object.
Definition at line 51 of file ControlNet.cpp.
Isis::ControlNet::ControlNet | ( | const QString & | ptfile, |
Progress * | progress = 0 |
||
) |
Creates a ControlNet object with the given list of control points and cubes.
ptfile | Name of file containing a Pvl list of control points |
progress | A pointer to the progress of reading in the control points |
Definition at line 95 of file ControlNet.cpp.
void Isis::ControlNet::AddPoint | ( | ControlPoint * | point | ) |
Adds a ControlPoint to the ControlNet.
point | Control point to be added |
Isis::IException::Programmer | - "ControlPoint must have unique Id" |
Definition at line 256 of file ControlNet.cpp.
References _FILEINFO_, Isis::ControlPoint::GetId(), Isis::ControlPoint::getMeasures(), and Isis::ControlPoint::parentNetwork.
double Isis::ControlNet::AverageResidual | ( | ) |
Compute the average error of all points in the network.
Definition at line 1113 of file ControlNet.cpp.
References Isis::Statistics::Average(), and Isis::ControlPoint::GetStatistic().
Calculate the band width and critical edges needed by the adjacency matrix that could store cube connectivity if that matrix used the same ordering as is in the provided list.
Note that no adjacency matrices are ever used in this class!
Critical edges are edges that contribute to band width.
serials | A list of cube serial numbers. |
Definition at line 558 of file ControlNet.cpp.
Isis::Camera * Isis::ControlNet::Camera | ( | int | index | ) |
Returns the camera list from the given image number.
index | The image number |
Definition at line 1142 of file ControlNet.cpp.
Referenced by Isis::QnetPointDistanceFilter::filter(), Isis::QnetCubeDistanceFilter::filter(), and Isis::QnetSetAprioriDialog::setApriori().
void Isis::ControlNet::ClearJigsawRejected | ( | ) |
Sets jigsaw rejected flag to false for all points and measures.
Called by BundleAdjust::Init method
Definition at line 1334 of file ControlNet.cpp.
References Isis::ControlPoint::ClearJigsawRejected().
void Isis::ControlNet::ComputeApriori | ( | ) |
Compute aprior values for each point in the network.
Definition at line 1095 of file ControlNet.cpp.
References Isis::ControlPoint::ComputeApriori().
void Isis::ControlNet::ComputeResiduals | ( | ) |
Compute error for each point in the network.
Definition at line 1079 of file ControlNet.cpp.
bool Isis::ControlNet::ContainsPoint | ( | QString | pointId | ) | const |
pointId | the point Id to check for in the network. |
Definition at line 683 of file ControlNet.cpp.
Referenced by Isis::QnetNewPointDialog::enableOkButton(), and Isis::MatchToolNewPointDialog::MatchToolNewPointDialog().
QString Isis::ControlNet::CreatedDate | ( | ) | const |
QString Isis::ControlNet::CubeGraphToString | ( | ) | const |
Used for verifying graph intergrity.
Definition at line 924 of file ControlNet.cpp.
void Isis::ControlNet::DecrementNumberOfRejectedMeasuresInImage | ( | const QString & | serialNumber | ) |
Decrement number of jigsaw rejected measures in image specified by serialNumber.
Definition at line 1354 of file ControlNet.cpp.
void Isis::ControlNet::DeleteMeasuresWithId | ( | QString | serialNumber | ) |
Essentially removes a cube from the networkid.
serialNumber | The cube serial number to be removed from the network |
Definition at line 1063 of file ControlNet.cpp.
References Isis::ControlPoint::Delete().
int Isis::ControlNet::DeletePoint | ( | ControlPoint * | point | ) |
Delete a ControlPoint from the network by the point's address.
point | The point to delete |
Definition at line 596 of file ControlNet.cpp.
References _FILEINFO_, and Isis::ControlPoint::GetId().
Referenced by Isis::ControlNetFilter::FilterOutPoint().
int Isis::ControlNet::DeletePoint | ( | QString | pointId | ) |
Delete a ControlPoint from the network using the point's Id.
pointId | The Point Id of the ControlPoint to be deleted. |
Definition at line 614 of file ControlNet.cpp.
References _FILEINFO_, and Isis::ControlPoint::getMeasures().
int Isis::ControlNet::DeletePoint | ( | int | index | ) |
Delete a ControlPoint from the network using the point's index.
index | The index of the Control Point to be deleted. |
Definition at line 668 of file ControlNet.cpp.
References _FILEINFO_.
QString Isis::ControlNet::Description | ( | ) | const |
Return the description of the network.
Definition at line 1164 of file ControlNet.cpp.
ControlPoint * Isis::ControlNet::FindClosest | ( | QString | serialNumber, |
double | sample, | ||
double | line | ||
) |
Finds and returns a pointer to the closest ControlPoint to the ControlMeasure with the given serial number and line sample location.
serialNumber | The serial number of the the file the ControlMeasure is on |
sample | The sample number of the ControlMeasure |
line | The line number of the ControlMeasure |
Definition at line 1181 of file ControlNet.cpp.
References _FILEINFO_.
QList< ControlCubeGraphNode * > Isis::ControlNet::GetCubeGraphNodes | ( | ) |
Definition at line 959 of file ControlNet.cpp.
QList< QString > Isis::ControlNet::GetCubeSerials | ( | ) | const |
Use this method to get a complete list of all the cube serial numbers in the network.
Note that the order in which the serials are ordered in the returned list is arbitrary and could change each time this method is called (but the operation is done in constant time).
Definition at line 951 of file ControlNet.cpp.
Referenced by Isis::CnetDisplayProperties::getCubeList(), and Isis::ChipViewport::paintEvent().
int Isis::ControlNet::getEdgeCount | ( | ) | const |
Definition at line 908 of file ControlNet.cpp.
double Isis::ControlNet::GetMaximumResidual | ( | ) |
Determine the maximum error of all points in the network.
Definition at line 1238 of file ControlNet.cpp.
References Isis::ControlPoint::GetStatistic(), and Isis::Statistics::Maximum().
QList< ControlMeasure * > Isis::ControlNet::GetMeasuresInCube | ( | QString | serialNumber | ) |
Get all the measures pertaining to a given cube serial number.
Definition at line 984 of file ControlNet.cpp.
Referenced by Isis::ChipViewport::paintEvent().
QList< QList< ControlCubeGraphNode * > > Isis::ControlNet::GetNodeConnections | ( | ) | const |
This method searches through all the cube serial numbers in the network.
Serials which are connected to other serials through points are grouped together in the same lists. The list containing the lists of strings is nothing more than a list of islands such that each island is a list of serials which are connected to each other. If the control network is completely connected, then this list will only have one element (a list of all the serials in the network).
Definition at line 723 of file ControlNet.cpp.
int Isis::ControlNet::GetNumberOfJigsawRejectedMeasuresInImage | ( | const QString & | serialNumber | ) |
Return the number of jigsaw rejected measures in image specified by serialNumber.
Definition at line 1324 of file ControlNet.cpp.
int Isis::ControlNet::GetNumberOfValidMeasuresInImage | ( | const QString & | serialNumber | ) |
Return the number of measures in image specified by serialNumber.
Definition at line 1314 of file ControlNet.cpp.
int Isis::ControlNet::GetNumEditLockMeasures | ( | ) |
Return the total number of edit locked measures for all control points in the network.
Definition at line 1264 of file ControlNet.cpp.
References Isis::ControlPoint::GetNumLockedMeasures().
int Isis::ControlNet::GetNumEditLockPoints | ( | ) |
Returns the number of edit locked control points.
Definition at line 1279 of file ControlNet.cpp.
int Isis::ControlNet::GetNumIgnoredMeasures | ( | ) |
Return the total number of ignored measures for all control points in the network.
Definition at line 1296 of file ControlNet.cpp.
References Isis::ControlPoint::GetNumValidMeasures().
int Isis::ControlNet::GetNumMeasures | ( | ) | const |
Returns the total number of measures for all control points in the network.
Definition at line 1365 of file ControlNet.cpp.
int Isis::ControlNet::GetNumPoints | ( | ) | const |
Return the number of control points in the network.
Definition at line 1376 of file ControlNet.cpp.
Referenced by Isis::Histogram::addMeasureDataFromNet(), Isis::ControlNetGraphicsItem::buildChildren(), Isis::ControlGraph::ControlGraph(), Isis::ControlNetFilter::CubeDistanceFilter(), Isis::QnetNavTool::deletePoints(), Isis::QnetPointDistanceFilter::filter(), Isis::QnetCubePointsFilter::filter(), Isis::QnetCubeDistanceFilter::filter(), Isis::QnetNavTool::filterList(), Isis::InterestOperator::FindCnetRef(), Isis::ControlGraph::HashCubesAndPopulateGraph(), Isis::ChipViewport::paintEvent(), Isis::ControlNetFilter::PointCubeNamesFilter(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointEditLockFilter(), Isis::ControlNetFilter::PointGoodnessOfFitFilter(), Isis::ControlNetFilter::PointIDFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::ControlNetFilter::PointMeasurePropertiesFilter(), Isis::ControlNetFilter::PointMeasuresFilter(), Isis::ControlNetFilter::PointNumMeasuresEditLockFilter(), Isis::ControlNetFilter::PointPixelShiftFilter(), Isis::ControlNetFilter::PointPropertiesFilter(), Isis::ControlNetFilter::PointResMagnitudeFilter(), Isis::Histogram::rangesFromNet(), and Isis::QnetNavTool::resetList().
int Isis::ControlNet::GetNumValidMeasures | ( | ) |
Return the number of valid (non-ignored) measures for all control points in the network.
Definition at line 1390 of file ControlNet.cpp.
References Isis::ControlPoint::GetNumValidMeasures().
int Isis::ControlNet::GetNumValidPoints | ( | ) |
Returns the number of non-ignored control points.
Definition at line 1406 of file ControlNet.cpp.
QList< QString > Isis::ControlNet::GetPointIds | ( | ) | const |
Return QList of ControlPoint Ids used in hash, in order of addition.
Definition at line 1442 of file ControlNet.cpp.
QList< ControlPoint * > Isis::ControlNet::GetPoints | ( | ) |
Return QList of ControlPoints ordered by point ID.
Definition at line 1430 of file ControlNet.cpp.
This method searches through all the cube serial numbers in the network.
Serials which are connected to other serials through points are grouped together in the same lists. The list containing the lists of strings is nothing more than a list of islands such that each island is a list of serials which are connected to each other. If the control network is completely connected, then this list will only have one element (a list of all the serials in the network).
Definition at line 699 of file ControlNet.cpp.
Referenced by Isis::MosaicControlNetTool::displayConnectivity().
QString Isis::ControlNet::GetTarget | ( | ) | const |
Return the target name.
Definition at line 1418 of file ControlNet.cpp.
std::vector< Distance > Isis::ControlNet::GetTargetRadii | ( | ) |
Get the target radii.
Definition at line 1758 of file ControlNet.cpp.
Referenced by Isis::QnetSetAprioriDialog::setApriori(), and Isis::ControlPoint::SetAprioriSurfacePoint().
QString Isis::ControlNet::GetUserName | ( | ) | const |
Return the user name.
Definition at line 1424 of file ControlNet.cpp.
void Isis::ControlNet::IncrementNumberOfRejectedMeasuresInImage | ( | const QString & | serialNumber | ) |
Increment number of jigsaw rejected measures in image specified by serialNumber.
Definition at line 1345 of file ControlNet.cpp.
bool Isis::ControlNet::IsValid | ( | ) | const |
Return if the control point is invalid.
Definition at line 1227 of file ControlNet.cpp.
|
private |
Updates the ControlCubeGraphNode for the measure's serial number to reflect the addition.
If there is currently no ControlCubeGraphNode for this measure's serial, then a new ControlCubeGraphNode is created with this measure as its first.
measure | The measure added to the network. |
Definition at line 289 of file ControlNet.cpp.
References _FILEINFO_, Isis::ControlCubeGraphNode::addMeasure(), Isis::ControlMeasure::GetCubeSerialNumber(), Isis::ControlPoint::GetId(), and Isis::ControlPoint::GetMeasure().
Referenced by Isis::ControlPoint::AddMeasure().
|
private |
Updates the ControlCubeGraphNode for this measure's serial number to reflect the deletion.
If this is the only measure left in the containing ControlCubeGraphNode, then the ControlCubeGraphNode is deleted as well.
measure | The measure removed from the network. |
Definition at line 420 of file ControlNet.cpp.
References Isis::ControlMeasure::GetCubeSerialNumber().
Referenced by Isis::ControlPoint::Delete().
|
private |
Updates the connections for the ControlCubeGraphNode associated with the measure's serial number to reflect the unignoration.
measure | The measure unignored from the network. |
Definition at line 347 of file ControlNet.cpp.
References _FILEINFO_, Isis::ControlMeasure::GetCubeSerialNumber(), Isis::ControlPoint::GetId(), and Isis::ControlPoint::GetMeasure().
Referenced by Isis::ControlPoint::SetIgnored().
QSet< ControlMeasure * > Isis::ControlNet::MinimumSpanningTree | ( | QList< ControlCubeGraphNode * > & | island, |
bool | lessThanconst ControlMeasure *, const ControlMeasure * | ||
) | const |
This method uses Kruskal's Algorithm to construct a minimum spanning tree of the given island, with control measures acting as the edges between graph nodes.
Because measures do not directly connect graph nodes, but rather connect graph nodes to control points, points are considered "intermediate vertices". When building the tree, we treat points like normal graph node vertices, but after the tree is built, we prune away any measures that, in conjunction with a point, form an "incomplete edge". Such an edge goes from a graph node to a point, but does not have another edge going from that point to another node. Since the primary purpose of this tree is to evaluate image connectivity, such edges are unnecessary. A "complete edge" consists of two measures and a point, and connects two graph nodes, or images.
The cost of each edge is determined by the provided less-than comparison function. If a Control Measure is less-than another, it is said to have a lower cost, and is thus more likely to appear in the minimum spanning tree.
Minimum spanning trees are constructed on islands, not networks, so it is important that the caller first retrieve the list of islands in the network from the GetNodeConnections() method before invoking this method. Creating a minimum spanning tree for an entire network with multiple islands would be impractical, as this method does not account for the possibility that some nodes are disconnected in the input.
A common usage of the minimum spanning tree is to measure the importance of a given measure or point to the overall connectivity of a network. If a measurement is not in the MST, we do not need to worry about creating additional islands by removing it.
It is important that the user choose their less-than function carefully. If a poor less-than function is used, then "bad" measures could end up in the MST while "good" measures are excluded, thus giving the user the false impression that a good measure can be safely deleted, while a bad measure must be preserved. The application "cnetwinnow", for example, tries to remove as many measures with high residuals as possible without increasing the island count of the network, so its less-than function compares the residual magnitude of the two input measures.
island | The list of graph nodes forming the island to be minimized |
lessThan | A comparison function telling us if one measure is better than another |
Definition at line 789 of file ControlNet.cpp.
References _FILEINFO_, Isis::ControlPoint::GetId(), Isis::ControlNet::ControlVertex::getPoint(), and Isis::ControlNet::ControlVertex::getRoot().
ControlNet & Isis::ControlNet::operator= | ( | const ControlNet & | other | ) |
Assign other to this.
This is an exception-safe assignment operator.
other | The control net to assign to this. |
Definition at line 1676 of file ControlNet.cpp.
|
private |
Random breadth-first search.
This meathod starts at a random serial, and returns a list with the start serial as well as any serial which is directly or indirectly connected to it. The list returned will contain all the serials in the network if and only if the network is completely connected. Otherwise, the list returned will be the entire island on which a random image resides.
Definition at line 495 of file ControlNet.cpp.
void Isis::ControlNet::ReadControl | ( | const QString & | filename, |
Progress * | progress = 0 |
||
) |
Reads in the control points from the given file.
ptfile | Name of file containing a Pvl list of control points |
progress | A pointer to the progress of reading in the control points |
Isis::iException::User | - "Invalid Network Type" |
Isis::iException::User | - "Invalid Control Point" |
Isis::iException::User | - "Invalid Format" |
2009-04-07 Tracie Sucharski - Keep track of ignored measures.
2010-08-06 Tracie Sucharski, Updated for changes made after additional working sessions for Control network design.
2011-04-02 Debbie A. Cook - Added code to set the target radii in the surface points of the control points as they are read into memory instead of setting parent prematurely to be able to set the radii in ControlPoint.
Definition at line 161 of file ControlNet.cpp.
References Isis::Progress::CheckStatus(), Isis::ControlNetFileV0002::GetNetworkHeader(), Isis::ControlNetFileV0002::GetNetworkPoints(), Isis::Progress::SetMaximumSteps(), and Isis::Progress::SetText().
void Isis::ControlNet::SetCreatedDate | ( | const QString & | date | ) |
Set the creation time.
date | The date this Control Network was created |
Definition at line 1452 of file ControlNet.cpp.
void Isis::ControlNet::SetDescription | ( | const QString & | newDescription | ) |
Set the description of the network.
desc | The description of this Control Network |
Definition at line 1462 of file ControlNet.cpp.
void Isis::ControlNet::SetImages | ( | const QString & | imageListFile | ) |
Creates the ControlNet's image cameras based on an input file.
imageListFile | The list of images |
Definition at line 1472 of file ControlNet.cpp.
Referenced by Isis::QnetFileTool::open().
void Isis::ControlNet::SetImages | ( | SerialNumberList & | list, |
Progress * | progress = 0 |
||
) |
Creates the ControlNet's image camera's based on the list of Serial Numbers.
list | The list of Serial Numbers |
progress | A pointer to the progress of creating the cameras |
Isis::iException::System | - "Unable to create camera for cube file" |
Isis::iException::User | - "Control point measure does not have a cube with a matching serial number" |
Definition at line 1491 of file ControlNet.cpp.
References _FILEINFO_, Isis::Progress::CheckStatus(), Isis::SerialNumberList::FileName(), Isis::ControlMeasure::GetCubeSerialNumber(), Isis::ControlPoint::getCubeSerialNumbers(), Isis::ControlPoint::GetId(), Isis::SerialNumberList::HasSerialNumber(), Isis::SerialNumberList::SerialNumber(), Isis::ControlMeasure::SetCamera(), Isis::Progress::SetMaximumSteps(), Isis::Progress::SetText(), and Isis::SerialNumberList::Size().
void Isis::ControlNet::SetModifiedDate | ( | const QString & | date | ) |
Set the last modified date.
date | The last date this Control Network was modified |
Definition at line 1554 of file ControlNet.cpp.
void Isis::ControlNet::SetMutex | ( | QMutex * | mutex | ) |
Set mutex to lock for making Naif calls.
mutex |
Definition at line 1566 of file ControlNet.cpp.
void Isis::ControlNet::SetNetworkId | ( | const QString & | id | ) |
Set the network id.
id | The Id of this Control Network |
Definition at line 1576 of file ControlNet.cpp.
void Isis::ControlNet::SetTarget | ( | const QString & | target | ) |
Set the target name.
target | The name of the target of this Control Network |
Definition at line 1586 of file ControlNet.cpp.
Referenced by Isis::QnetFileTool::open().
void Isis::ControlNet::SetUserName | ( | const QString & | name | ) |
Set the user name.
name | The name of the user creating or modifying this Control Net |
Definition at line 1619 of file ControlNet.cpp.
Referenced by Isis::QnetFileTool::open().
|
private |
Shuffles the QStrings in a QList< QString >
list | The list to be shuffled |
Definition at line 534 of file ControlNet.cpp.
QList< ControlMeasure * > Isis::ControlNet::sortedMeasureList | ( | double(ControlMeasure::*)() const | statFunc, |
double | min, | ||
double | max | ||
) |
Get a sorted list of all the measures that have values in a given ragen.
statFunc | A pointer to a control Measure acessor |
min | the minimum value of acessor return for list inclusion |
max | the maximum value of acessor return for list inclusion |
Definition at line 1027 of file ControlNet.cpp.
References Isis::ControlPoint::GetMeasure().
void Isis::ControlNet::swap | ( | ControlNet & | other | ) |
Swaps the member data with the given control net.
This is an optimized form of: ControlNet a = ... ControlNet b = ...
Swap 'a' and 'b' ControlNet tmp = a; a = b; b = tmp;
This is used primarily for the assignment operator in order to do copy-and-swap.
other | The control net to swap with. |
Definition at line 1638 of file ControlNet.cpp.
References cubeGraphNodes, p_cameraList, p_cameraMap, p_cameraRejectedMeasuresMap, p_cameraValidMeasuresMap, p_created, p_description, p_invalid, p_modified, p_networkId, p_targetName, p_targetRadii, p_userName, and points.
|
private |
Updates the key reference (poind Id) from the old one to what the point id was changet to.
This method should only be called from ControlPoint's SetId().
point | The point that needs to be updated. |
oldId | The pointId that the point had. |
Definition at line 406 of file ControlNet.cpp.
References Isis::ControlPoint::GetId().
Referenced by Isis::ControlPoint::SetId().
|
private |
Does a check to ensure that the given serial number is contained within the network.
If it is not, then an exception is thrown
serialNumber | the cube serial number to validate |
Definition at line 970 of file ControlNet.cpp.
References _FILEINFO_.
void Isis::ControlNet::Write | ( | const QString & | ptfile, |
bool | pvl = false |
||
) |
Writes out the control network.
ptfile | Name of file containing a Pvl list of control points |
pvl | Boolean indicating whether to write in pvl format (Default=false) |
Isis::iException::Programmer | - "Invalid Net Enumeration" |
Isis::iException::Io | - "Unable to write PVL infomation to file" |
Definition at line 219 of file ControlNet.cpp.
References Isis::ControlNetFileV0002::GetNetworkHeader(), and Isis::ControlNetFileV0002::GetNetworkPoints().
Referenced by Isis::ExportControlNetWorkOrder::asyncRedo(), Isis::QnetFileTool::save(), and Isis::QnetFileTool::saveAs().
|
private |
hash ControlCubeGraphNodes by CubeSerialNumber
Definition at line 399 of file ControlNet.h.
Referenced by swap().
|
private |
Vector of image number to camera.
Definition at line 413 of file ControlNet.h.
Referenced by swap().
|
private |
A map from serialnumber to camera.
Definition at line 409 of file ControlNet.h.
Referenced by swap().
|
private |
A map from serialnumber to
#rejected measures
Definition at line 411 of file ControlNet.h.
Referenced by swap().
|
private |
A map from serialnumber to #measures.
Definition at line 410 of file ControlNet.h.
Referenced by swap().
|
private |
|
private |
|
private |
If the Control Network is currently invalid.
Definition at line 416 of file ControlNet.h.
Referenced by swap().
|
private |
|
private |
|
private |
|
private |
|
private |
The user who created the network.
Definition at line 408 of file ControlNet.h.
Referenced by swap().
|
private |
hash ControlPoints by ControlPoint Id
Definition at line 396 of file ControlNet.h.
Referenced by swap().