/***************************************************************************** * Open MCT, Copyright (c) 2014-2018, United States Government * as represented by the Administrator of the National Aeronautics and Space * Administration. All rights reserved. * * Open MCT is licensed under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. * You may obtain a copy of the License at * http://www.apache.org/licenses/LICENSE-2.0. * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * * Open MCT includes source code licensed under additional open source * licenses. See the Open Source Licenses file (LICENSES.md) included with * this source code distribution or the Licensing information page available * at runtime from the About dialog for additional information. *****************************************************************************/ /*global console*/ define([ 'lodash' ], function ( _ ) { function applyReasonableDefaults(valueMetadata, index) { valueMetadata.source = valueMetadata.source || valueMetadata.key; valueMetadata.hints = valueMetadata.hints || {}; if (valueMetadata.hints.hasOwnProperty('x')) { console.warn( 'DEPRECATION WARNING: `x` hints should be replaced with ' + '`domain` hints moving forward. ' + 'https://github.com/nasa/openmct/issues/1546' ); if (!valueMetadata.hints.hasOwnProperty('domain')) { valueMetadata.hints.domain = valueMetadata.hints.x; } delete valueMetadata.hints.x; } if (valueMetadata.hints.hasOwnProperty('y')) { console.warn( 'DEPRECATION WARNING: `y` hints should be replaced with ' + '`range` hints moving forward. ' + 'https://github.com/nasa/openmct/issues/1546' ); if (!valueMetadata.hints.hasOwnProperty('range')) { valueMetadata.hints.range = valueMetadata.hints.y; } delete valueMetadata.hints.y; } if (valueMetadata.format === 'enum') { if (!valueMetadata.values) { valueMetadata.values = _.pluck(valueMetadata.enumerations, 'value'); } if (!valueMetadata.hasOwnProperty('max')) { valueMetadata.max = _.max(valueMetadata.values) + 1; } if (!valueMetadata.hasOwnProperty('min')) { valueMetadata.min = _.min(valueMetadata.values) - 1; } } if (!valueMetadata.hints.hasOwnProperty('priority')) { valueMetadata.hints.priority = index; } return valueMetadata; } /** * Utility class for handling and inspecting telemetry metadata. Applies * reasonable defaults to simplify the task of providing metadata, while * also providing methods for interrogating telemetry metadata. */ function TelemetryMetadataManager(metadata) { this.metadata = metadata; this.valueMetadatas = this.metadata.values.map(applyReasonableDefaults); } /** * Get value metadata for a single key. */ TelemetryMetadataManager.prototype.value = function (key) { return this.valueMetadatas.filter(function (metadata) { return metadata.key === key; })[0]; }; /** * Returns all value metadatas, sorted by priority. */ TelemetryMetadataManager.prototype.values = function () { return this.valuesForHints(['priority']); }; /** * Get an array of valueMetadatas that posess all hints requested. * Array is sorted based on hint priority. * */ TelemetryMetadataManager.prototype.valuesForHints = function ( hints ) { function hasHint(hint) { /*jshint validthis: true */ return this.hints.hasOwnProperty(hint); } function hasHints(metadata) { return hints.every(hasHint, metadata); } var matchingMetadata = this.valueMetadatas.filter(hasHints); var sortedMetadata = _.sortBy(matchingMetadata, function (metadata) { return hints.map(function (hint) { return metadata.hints[hint]; }); }); return sortedMetadata; }; return TelemetryMetadataManager; });