Updated Trial Criteria selection, added groundwork for allowing multiple criteria (LT-188)

This commit is contained in:
Erik Ziegler committed 2016-03-07 13:36:48 +01:00
1 parent 9970b8795b
commit c4ad6b04b5
7 files changed
+175 -133

No files matched your search

@@ -321,70 +321,78 @@ function irRC(image) {
* Retrieve trial criteria constraints based on the image that measurements appear upon
* If no image is specified, it is assumed that group or per Organ level criteria are desired.
*
* @param criteriaType A valid Trial Criteria set name (e.g. 'RECIST' or 'irRC')
* @param criteriaTypes An array of valid Trial Criteria set names (e.g. ['RECIST', 'irRC'])
* NOTE: Multiple criteria are not yet supported
*
* @param imageId A Cornerstone Image ID
* @returns {*} An Object of Trial Criteria that can be used to validate measurements' conformance
*/
getTrialCriteriaConstraints = function(criteriaType, imageId) {
if (!TrialCriteriaConstraints[criteriaType]) {
throw 'No such Trial Criteria defined: ' + criteriaType;
}
getTrialCriteriaConstraints = function(criteriaTypes, imageId) {
// TODO: update this when we allow multiple criteria
var allCriteria = [];
criteriaTypes.forEach(function(criteriaType) {
if (!TrialCriteriaConstraints[criteriaType]) {
throw 'No such Trial Criteria defined: ' + criteriaType;
}
// If no imageId was specified, skip customization of the criteria
// and return the requested criteria right away
var criteria;
if (!imageId) {
criteria = TrialCriteriaConstraints[criteriaType]();
return criteria;
}
// If no imageId was specified, skip customization of the criteria
// and return the requested criteria right away
var criteria;
if (!imageId) {
criteria = TrialCriteriaConstraints[criteriaType]();
return criteria;
}
// Otherwise, retrieve the series metaData to identify the modality of the image
var seriesMetaData = cornerstoneTools.metaData.get('series', imageId);
if (!seriesMetaData) {
return;
}
// Otherwise, retrieve the series metaData to identify the modality of the image
var seriesMetaData = cornerstoneTools.metaData.get('series', imageId);
if (!seriesMetaData) {
return;
}
// TODO: Get the rest of the metaData that has already been loaded by Cornerstone
var image = {};
// TODO: Get the rest of the metaData that has already been loaded by Cornerstone
var image = {};
// If we are looking at an MR or CT image, we should pass the slice thickness
// to the Trial Criteria functions so that they can customize the validation rules
if (seriesMetaData.modality === 'MR' || seriesMetaData.modality === 'CT') {
var instanceMetaData = cornerstoneTools.metaData.get('instance', imageId);
image.acquisitionSliceThickness = instanceMetaData.sliceThickness;
}
// If we are looking at an MR or CT image, we should pass the slice thickness
// to the Trial Criteria functions so that they can customize the validation rules
if (seriesMetaData.modality === 'MR' || seriesMetaData.modality === 'CT') {
var instanceMetaData = cornerstoneTools.metaData.get('instance', imageId);
image.acquisitionSliceThickness = instanceMetaData.sliceThickness;
}
// Retrieve the study metaData in order to find the timepoint type
var studyMetaData = cornerstoneTools.metaData.get('study', imageId);
if (!studyMetaData) {
return;
}
// Retrieve the study metaData in order to find the timepoint type
var studyMetaData = cornerstoneTools.metaData.get('study', imageId);
if (!studyMetaData) {
return;
}
// Retrieve the Study document from the Collection of associated Studies
var study = Studies.findOne({
studyInstanceUid: studyMetaData.studyInstanceUid
// Retrieve the Study document from the Collection of associated Studies
var study = Studies.findOne({
studyInstanceUid: studyMetaData.studyInstanceUid
});
if (!study) {
return;
}
// Find the related Timepoint document
var timepoint = Timepoints.findOne({
timepointId: study.timepointId
});
if (!timepoint) {
log.warn('Timepoint related to study is missing.');
return;
}
// Retrieve the Timepoint's type (e.g. 'baseline' or 'followup')
var timepointType = timepoint.timepointType;
// Obtain the customized trial criteria given the image metaData
criteria = TrialCriteriaConstraints[criteriaType](image);
// Return the relevant criteria given the current timepoint type
allCriteria.push(criteria[timepointType]);
});
if (!study) {
return;
}
// Find the related Timepoint document
var timepoint = Timepoints.findOne({
timepointId: study.timepointId
});
if (!timepoint) {
log.warn('Timepoint related to study is missing.');
return;
}
// Retrieve the Timepoint's type (e.g. 'baseline' or 'followup')
var timepointType = timepoint.timepointType;
// Obtain the customized trial criteria given the image metaData
criteria = TrialCriteriaConstraints[criteriaType](image);
// Return the relevant criteria given the current timepoint type
return criteria[timepointType];
return allCriteria[0];
};
@@ -70,13 +70,9 @@ function assessGroupOfMeasurements(constraints) {
type: type
});
// Get the criteria type so we can calculate total lesion burden
var criteriaType = Session.get('TrialResponseAssessmentCriteria');
// Calculate some simple group-level Measurement statistics for validation
var testStructure = {
totalNumberOfLesions: Measurements.find().count(),
totalLesionBurden: calculateTotalLesionBurden(criteriaType)
totalNumberOfLesions: Measurements.find().count()
};
// Run the conformance checks with the validate.js library
@@ -220,8 +216,12 @@ function assessSingleMeasurement(constraints, measurementData) {
function validateSingleMeasurement(measurementData) {
// Obtain the name of the current TrialResponseAssessmentCriteria that
// we are using.
var criteriaType = Session.get('TrialResponseAssessmentCriteria');
var currentConstraints = getTrialCriteriaConstraints(criteriaType, measurementData.imageId);
var criteriaTypes = TrialCriteriaTypes.find({
selected: true
}).map(function(criteria) {
return criteria.id;
});
var currentConstraints = getTrialCriteriaConstraints(criteriaTypes, measurementData.imageId);
// If we have no relevant constraints, stop here
if (!currentConstraints) {
@@ -264,12 +264,16 @@ function validateSingleMeasurement(measurementData) {
function validateGroups() {
log.info('validateGroups');
// Obtain the name of the current TrialResponseAssessmentCriteria that
// Obtain the names of the current TrialResponseAssessmentCriteria that
// we are using.
var criteriaType = Session.get('TrialResponseAssessmentCriteria');
var criteriaTypes = TrialCriteriaTypes.find({
selected: true
}).map(function(criteria) {
return criteria.id;
});
// Criteria for the specific image are retrieved from the general set of criteria.
var currentConstraints = getTrialCriteriaConstraints(criteriaType);
var currentConstraints = getTrialCriteriaConstraints(criteriaTypes);
if (!currentConstraints) {
return;
}
@@ -297,10 +301,13 @@ function validateGroups() {
}
function validateAll() {
log.info('validateAll');
// Obtain the name of the current TrialResponseAssessmentCriteria that
// Obtain the names of the current TrialResponseAssessmentCriteria that
// we are using.
var criteriaType = Session.get('TrialResponseAssessmentCriteria');
var criteriaTypes = TrialCriteriaTypes.find({
selected: true
}).map(function(criteria) {
return criteria.id;
});
Measurements.find().forEach(function(measurement) {
Object.keys(measurement.timepoints).forEach(function(timepointId) {
@@ -311,7 +318,7 @@ function validateAll() {
currentMeasurement._id = measurement._id;
// Criteria for the specific image are retrieved from the general set of criteria.
var currentConstraints = getTrialCriteriaConstraints(criteriaType, currentMeasurement.imageId);
var currentConstraints = getTrialCriteriaConstraints(criteriaTypes, currentMeasurement.imageId);
if (!currentConstraints) {
return;
}
@@ -333,8 +340,6 @@ var validationTimeout = 400;
* @param measurementData Input measurement data from CornerstoneTools
*/
function validateDelayed(measurementData) {
log.info('validateAllDelayed');
// Erase any currently-waiting validation call
clearTimeout(validationTimeout);