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.omm;
18  
19  import java.io.IOException;
20  
21  import org.orekit.data.DataContext;
22  import org.orekit.files.ccsds.definitions.TimeSystem;
23  import org.orekit.files.ccsds.ndm.ParsedUnitsBehavior;
24  import org.orekit.files.ccsds.ndm.odm.CartesianCovarianceWriter;
25  import org.orekit.files.ccsds.ndm.odm.OdmHeader;
26  import org.orekit.files.ccsds.ndm.odm.SpacecraftParametersWriter;
27  import org.orekit.files.ccsds.ndm.odm.UserDefinedWriter;
28  import org.orekit.files.ccsds.section.Segment;
29  import org.orekit.files.ccsds.section.XmlStructureKey;
30  import org.orekit.files.ccsds.utils.ContextBinding;
31  import org.orekit.files.ccsds.utils.FileFormat;
32  import org.orekit.files.ccsds.utils.generation.AbstractMessageWriter;
33  import org.orekit.files.ccsds.utils.generation.Generator;
34  import org.orekit.time.AbsoluteDate;
35  import org.orekit.utils.IERSConventions;
36  
37  
38  /**
39   * Writer for CCSDS Orbit Mean Mean-Elements Message.
40   *
41   * @author Luc Maisonobe
42   * @since 11.0
43   */
44  public class OmmWriter extends AbstractMessageWriter<OdmHeader, Segment<OmmMetadata, OmmData>, Omm> {
45  
46      /** Version number implemented. **/
47      public static final double CCSDS_OMM_VERS = 3.0;
48  
49      /** Padding width for aligning the '=' sign. */
50      public static final int KVN_PADDING_WIDTH = 19;
51  
52      /** Complete constructor.
53       * <p>
54       * Calling this constructor directly is not recommended. Users should rather use
55       * {@link org.orekit.files.ccsds.ndm.WriterBuilder#buildOmmWriter()
56       * writerBuilder.buildOmmWriter()}.
57       * </p>
58       * @param conventions IERS Conventions
59       * @param dataContext used to retrieve frames, time scales, etc.
60       * @param missionReferenceDate reference date for Mission Elapsed Time or Mission Relative Time time systems
61       */
62      public OmmWriter(final IERSConventions conventions, final DataContext dataContext,
63                       final AbsoluteDate missionReferenceDate) {
64          super(Omm.ROOT, Omm.FORMAT_VERSION_KEY, CCSDS_OMM_VERS,
65                new ContextBinding(
66                    () -> conventions, () -> false, () -> dataContext,
67                    () -> ParsedUnitsBehavior.STRICT_COMPLIANCE,
68                    () -> missionReferenceDate, () -> TimeSystem.UTC,
69                    () -> 0.0, () -> 1.0));
70      }
71  
72      /** {@inheritDoc} */
73      @Override
74      protected void writeSegmentContent(final Generator generator, final double formatVersion,
75                                         final Segment<OmmMetadata, OmmData> segment)
76          throws IOException {
77  
78          // write the metadata
79          final ContextBinding oldContext = getContext();
80          final OmmMetadata    metadata   = segment.getMetadata();
81          setContext(new ContextBinding(oldContext::getConventions,
82                                        oldContext::isSimpleEOP,
83                                        oldContext::getDataContext,
84                                        oldContext::getParsedUnitsBehavior,
85                                        oldContext::getReferenceDate,
86                                        metadata::getTimeSystem,
87                                        oldContext::getClockCount,
88                                        oldContext::getClockRate));
89          new OmmMetadataWriter(metadata, getTimeConverter()).write(generator);
90  
91          // start data block
92          if (generator.getFormat() == FileFormat.XML) {
93              generator.enterSection(XmlStructureKey.data.name());
94          }
95  
96          // write mandatory mean Keplerian elements block
97          new MeanKeplerianElementsWriter(XmlSubStructureKey.meanElements.name(), null,
98                                          segment.getData().getKeplerianElementsBlock(),
99                                          getTimeConverter(), segment.getMetadata().theoryIsSgpSdp()).
100         write(generator);
101 
102         if (segment.getData().getSpacecraftParametersBlock() != null) {
103             // write optional spacecraft parameters block
104             new SpacecraftParametersWriter(XmlSubStructureKey.spacecraftParameters.name(), null,
105                                            segment.getData().getSpacecraftParametersBlock()).
106             write(generator);
107         }
108 
109         if (segment.getData().getTLEBlock() != null) {
110             new OmmTleWriter(XmlSubStructureKey.tleParameters.name(), null,
111                              segment.getData().getTLEBlock()).
112             write(generator);
113         }
114 
115         if (segment.getData().getCovarianceBlock() != null) {
116             // write optional spacecraft parameters block
117             new CartesianCovarianceWriter(XmlSubStructureKey.covarianceMatrix.name(), null,
118                                           segment.getData().getCovarianceBlock()).
119             write(generator);
120         }
121 
122         if (segment.getData().getUserDefinedBlock() != null) {
123             // write optional user defined parameters block
124             new UserDefinedWriter(XmlSubStructureKey.userDefinedParameters.name(), null,
125                                   segment.getData().getUserDefinedBlock()).
126             write(generator);
127         }
128 
129         // stop data block
130         if (generator.getFormat() == FileFormat.XML) {
131             generator.exitSection();
132         }
133 
134     }
135 
136 }