OcmMetadataWriter.java

  1. /* Copyright 2002-2025 CS GROUP
  2.  * Licensed to CS GROUP (CS) under one or more
  3.  * contributor license agreements.  See the NOTICE file distributed with
  4.  * this work for additional information regarding copyright ownership.
  5.  * CS licenses this file to You under the Apache License, Version 2.0
  6.  * (the "License"); you may not use this file except in compliance with
  7.  * the License.  You may obtain a copy of the License at
  8.  *
  9.  *   http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */
  17. package org.orekit.files.ccsds.ndm.odm.ocm;

  18. import java.io.IOException;
  19. import java.util.stream.Collectors;

  20. import org.hipparchus.util.Precision;
  21. import org.orekit.files.ccsds.definitions.TimeConverter;
  22. import org.orekit.files.ccsds.ndm.odm.OdmMetadataKey;
  23. import org.orekit.files.ccsds.section.AbstractWriter;
  24. import org.orekit.files.ccsds.section.KvnStructureKey;
  25. import org.orekit.files.ccsds.section.MetadataKey;
  26. import org.orekit.files.ccsds.section.XmlStructureKey;
  27. import org.orekit.files.ccsds.utils.generation.Generator;
  28. import org.orekit.utils.units.Unit;

  29. /**
  30.  * Writer for Common metadata for CCSDS Orbit Comprehensive Messages.
  31.  *
  32.  * @author Luc Maisonobe
  33.  * @since 11.0
  34.  */
  35. class OcmMetadataWriter extends AbstractWriter {

  36.     /** Metadata. */
  37.     private final OcmMetadata metadata;

  38.     /** Converter for dates. */
  39.     private final TimeConverter timeConverter;

  40.     /** Simple constructor.
  41.      * @param metadata metadata to write
  42.      * @param timeConverter converter for dates
  43.      */
  44.     OcmMetadataWriter(final OcmMetadata metadata, final TimeConverter timeConverter) {
  45.         super(XmlStructureKey.metadata.name(), KvnStructureKey.META.name());
  46.         this.metadata      = metadata;
  47.         this.timeConverter = timeConverter;
  48.     }

  49.     /** {@inheritDoc} */
  50.     @Override
  51.     protected void writeContent(final Generator generator) throws IOException {

  52.         generator.writeComments(metadata.getComments());

  53.         // object
  54.         generator.writeEntry(OdmMetadataKey.OBJECT_NAME.name(),
  55.                              metadata.getObjectName(), null, false);
  56.         generator.writeEntry(OcmMetadataKey.INTERNATIONAL_DESIGNATOR.name(),
  57.                              metadata.getInternationalDesignator(), null, false);
  58.         generator.writeEntry(OcmMetadataKey.CATALOG_NAME.name(),
  59.                              metadata.getCatalogName(), null, false);
  60.         generator.writeEntry(OcmMetadataKey.OBJECT_DESIGNATOR.name(),
  61.                              metadata.getObjectDesignator(), null, false);
  62.         generator.writeEntry(OcmMetadataKey.ALTERNATE_NAMES.name(),
  63.                              metadata.getAlternateNames(), false);

  64.         // originator
  65.         generator.writeEntry(OcmMetadataKey.ORIGINATOR_POC.name(),
  66.                              metadata.getOriginatorPOC(), null, false);
  67.         generator.writeEntry(OcmMetadataKey.ORIGINATOR_POSITION.name(),
  68.                              metadata.getOriginatorPosition(), null, false);
  69.         generator.writeEntry(OcmMetadataKey.ORIGINATOR_PHONE.name(),
  70.                              metadata.getOriginatorPhone(), null, false);
  71.         generator.writeEntry(OcmMetadataKey.ORIGINATOR_EMAIL.name(),
  72.                              metadata.getOriginatorEmail(), null, false);
  73.         generator.writeEntry(OcmMetadataKey.ORIGINATOR_ADDRESS.name(),
  74.                              metadata.getOriginatorAddress(), null, false);

  75.         // technical
  76.         generator.writeEntry(OcmMetadataKey.TECH_ORG.name(),
  77.                              metadata.getTechOrg(), null, false);
  78.         generator.writeEntry(OcmMetadataKey.TECH_POC.name(),
  79.                              metadata.getTechPOC(), null, false);
  80.         generator.writeEntry(OcmMetadataKey.TECH_POSITION.name(),
  81.                              metadata.getTechPosition(), null, false);
  82.         generator.writeEntry(OcmMetadataKey.TECH_PHONE.name(),
  83.                              metadata.getTechPhone(), null, false);
  84.         generator.writeEntry(OcmMetadataKey.TECH_EMAIL.name(),
  85.                              metadata.getTechEmail(), null, false);
  86.         generator.writeEntry(OcmMetadataKey.TECH_ADDRESS.name(),
  87.                              metadata.getTechAddress(), null, false);

  88.         // messages
  89.         generator.writeEntry(OcmMetadataKey.PREVIOUS_MESSAGE_ID.name(),
  90.                              metadata.getPreviousMessageID(), null, false);
  91.         generator.writeEntry(OcmMetadataKey.NEXT_MESSAGE_ID.name(),
  92.                              metadata.getNextMessageID(), null, false);
  93.         generator.writeEntry(OcmMetadataKey.ADM_MSG_LINK.name(),
  94.                              metadata.getAdmMessageLink(), null, false);
  95.         generator.writeEntry(OcmMetadataKey.CDM_MSG_LINK.name(),
  96.                              metadata.getCdmMessageLink(), null, false);
  97.         generator.writeEntry(OcmMetadataKey.PRM_MSG_LINK.name(),
  98.                              metadata.getPrmMessageLink(), null, false);
  99.         generator.writeEntry(OcmMetadataKey.RDM_MSG_LINK.name(),
  100.                              metadata.getRdmMessageLink(), null, false);
  101.         generator.writeEntry(OcmMetadataKey.TDM_MSG_LINK.name(),
  102.                              metadata.getTdmMessageLink(), null, false);

  103.         // operator
  104.         generator.writeEntry(OcmMetadataKey.OPERATOR.name(),
  105.                              metadata.getOperator(), null, false);
  106.         generator.writeEntry(OcmMetadataKey.OWNER.name(),
  107.                              metadata.getOwner(), null, false);
  108.         generator.writeEntry(OcmMetadataKey.COUNTRY.name(),
  109.                              metadata.getCountry(), null, false);
  110.         generator.writeEntry(OcmMetadataKey.CONSTELLATION.name(),
  111.                              metadata.getConstellation(), null, false);
  112.         generator.writeEntry(OcmMetadataKey.OBJECT_TYPE.name(),
  113.                              metadata.getObjectType(), false);

  114.         // time
  115.         generator.writeEntry(MetadataKey.TIME_SYSTEM.name(),
  116.                              metadata.getTimeSystem(), false);
  117.         generator.writeEntry(OcmMetadataKey.EPOCH_TZERO.name(), timeConverter,
  118.                              metadata.getEpochT0(), true, true);

  119.         // definitions
  120.         generator.writeEntry(OcmMetadataKey.OPS_STATUS.name(),
  121.                              metadata.getOpsStatus(), false);
  122.         generator.writeEntry(OcmMetadataKey.ORBIT_CATEGORY.name(),
  123.                              metadata.getOrbitCategory(), false);
  124.         if (metadata.getOcmDataElements() != null) {
  125.             generator.writeEntry(OcmMetadataKey.OCM_DATA_ELEMENTS.name(),
  126.                                  metadata.getOcmDataElements().stream().map(Enum::name).collect(Collectors.toList()), false);
  127.         }

  128.         // other times
  129.         if (!(Precision.equals(metadata.getSclkOffsetAtEpoch(), OcmMetadata.DEFAULT_SCLK_OFFSET_AT_EPOCH) &&
  130.               Precision.equals(metadata.getSclkSecPerSISec(),   OcmMetadata.DEFAULT_SCLK_SEC_PER_SI_SEC))) {
  131.             generator.writeEntry(OcmMetadataKey.SCLK_OFFSET_AT_EPOCH.name(), metadata.getSclkOffsetAtEpoch(), Unit.SECOND, false);
  132.             generator.writeEntry(OcmMetadataKey.SCLK_SEC_PER_SI_SEC.name(),  metadata.getSclkSecPerSISec(),   Unit.SECOND, false);
  133.         }
  134.         generator.writeEntry(OcmMetadataKey.PREVIOUS_MESSAGE_EPOCH.name(), timeConverter,
  135.                              metadata.getPreviousMessageEpoch(), true, false);
  136.         generator.writeEntry(OcmMetadataKey.NEXT_MESSAGE_EPOCH.name(), timeConverter,
  137.                              metadata.getNextMessageEpoch(), true, false);
  138.         generator.writeEntry(OcmMetadataKey.START_TIME.name(), timeConverter,
  139.                              metadata.getStartTime(), false, false);
  140.         generator.writeEntry(OcmMetadataKey.STOP_TIME.name(), timeConverter,
  141.                              metadata.getStopTime(), false, false);
  142.         generator.writeEntry(OcmMetadataKey.TIME_SPAN.name(),        metadata.getTimeSpan(),  Unit.DAY,    false);
  143.         generator.writeEntry(OcmMetadataKey.TAIMUTC_AT_TZERO.name(), metadata.getTaimutcT0(), Unit.SECOND, false);
  144.         if (metadata.getNextLeapEpoch() != null) {
  145.             generator.writeEntry(OcmMetadataKey.NEXT_LEAP_EPOCH.name(), timeConverter,
  146.                                  metadata.getNextLeapEpoch(), true, true);
  147.             generator.writeEntry(OcmMetadataKey.NEXT_LEAP_TAIMUTC.name(), metadata.getNextLeapTaimutc(), Unit.SECOND, true);
  148.         }
  149.         generator.writeEntry(OcmMetadataKey.UT1MUTC_AT_TZERO.name(), metadata.getUt1mutcT0(), Unit.SECOND, false);

  150.         // data sources
  151.         generator.writeEntry(OcmMetadataKey.EOP_SOURCE.name(),
  152.                              metadata.getEopSource(), null, false);
  153.         generator.writeEntry(OcmMetadataKey.INTERP_METHOD_EOP.name(),
  154.                              metadata.getInterpMethodEOP(), null, false);
  155.         generator.writeEntry(OcmMetadataKey.CELESTIAL_SOURCE.name(),
  156.                              metadata.getCelestialSource(), null, false);

  157.     }

  158. }