/***************************************************************************************** * * * OpenSpace * * * * Copyright (c) 2014-2020 * * * * Permission is hereby granted, free of charge, to any person obtaining a copy of this * * software and associated documentation files (the "Software"), to deal in the Software * * without restriction, including without limitation the rights to use, copy, modify, * * merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * * permit persons to whom the Software is furnished to do so, subject to the following * * conditions: * * * * The above copyright notice and this permission notice shall be included in all copies * * or substantial portions of the Software. * * * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, * * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A * * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF * * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE * * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * ****************************************************************************************/ #include #include #include #include #include #include namespace { constexpr const char* KeyKernels = "Kernels"; constexpr openspace::properties::Property::PropertyInfo SourceInfo = { "SourceFrame", "Source", "This value specifies the source frame that is used as the basis for the " "coordinate transformation. This has to be a valid SPICE name." }; constexpr openspace::properties::Property::PropertyInfo DestinationInfo = { "DestinationFrame", "Destination", "This value specifies the destination frame that is used for the coordinate " "transformation. This has to be a valid SPICE name." }; constexpr openspace::properties::Property::PropertyInfo TimeFrameInfo = { "TimeFrame", "Time Frame", "The time frame in which the spice kernels are valid." }; } // namespace namespace openspace { documentation::Documentation SpiceRotation::Documentation() { using namespace openspace::documentation; return { "Spice Rotation", "space_transform_rotation_spice", { { "Type", new StringEqualVerifier("SpiceRotation"), Optional::No }, { SourceInfo.identifier, new StringAnnotationVerifier("A valid SPICE NAIF name or integer"), Optional::No, SourceInfo.description }, { DestinationInfo.identifier, new StringAnnotationVerifier("A valid SPICE NAIF name or integer"), Optional::No, DestinationInfo.description }, { KeyKernels, new OrVerifier({ new StringListVerifier, new StringVerifier }), Optional::Yes, "A single kernel or list of kernels that this SpiceTranslation depends " "on. All provided kernels will be loaded before any other operation is " "performed." }, { TimeFrameInfo.identifier, new ReferencingVerifier("core_time_frame"), Optional::Yes, TimeFrameInfo.description }, } }; } SpiceRotation::SpiceRotation(const ghoul::Dictionary& dictionary) : _sourceFrame(SourceInfo) , _destinationFrame(DestinationInfo) { documentation::testSpecificationAndThrow( Documentation(), dictionary, "SpiceRotation" ); _sourceFrame = dictionary.value(SourceInfo.identifier); _destinationFrame = dictionary.value(DestinationInfo.identifier); if (dictionary.hasKeyAndValue(KeyKernels)) { SpiceManager::ref().loadKernel(dictionary.value(KeyKernels)); } else if (dictionary.hasKeyAndValue(KeyKernels)) { ghoul::Dictionary kernels = dictionary.value(KeyKernels); for (size_t i = 1; i <= kernels.size(); ++i) { if (!kernels.hasKeyAndValue(std::to_string(i))) { throw ghoul::RuntimeError("Kernels has to be an array-style table"); } std::string kernel = kernels.value(std::to_string(i)); SpiceManager::ref().loadKernel(kernel); } } if (dictionary.hasKey(TimeFrameInfo.identifier)) { ghoul::Dictionary timeFrameDictionary; dictionary.getValue(TimeFrameInfo.identifier, timeFrameDictionary); _timeFrame = TimeFrame::createFromDictionary(timeFrameDictionary); if (_timeFrame == nullptr) { throw ghoul::RuntimeError("Invalid dictionary for TimeFrame."); } addPropertySubOwner(_timeFrame.get()); } addProperty(_sourceFrame); addProperty(_destinationFrame); _sourceFrame.onChange([this]() { requireUpdate(); }); _destinationFrame.onChange([this]() { requireUpdate(); }); } glm::dmat3 SpiceRotation::matrix(const UpdateData& data) const { if (_timeFrame && !_timeFrame->isActive(data.time)) { return glm::dmat3(1.0); } return SpiceManager::ref().positionTransformMatrix( _sourceFrame, _destinationFrame, data.time.j2000Seconds() ); } } // namespace openspace