1   /* Copyright 2002-2021 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.adm.apm;
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.adm.AdmMetadata;
25  import org.orekit.files.ccsds.ndm.adm.AdmMetadataWriter;
26  import org.orekit.files.ccsds.section.Header;
27  import org.orekit.files.ccsds.section.Segment;
28  import org.orekit.files.ccsds.section.XmlStructureKey;
29  import org.orekit.files.ccsds.utils.ContextBinding;
30  import org.orekit.files.ccsds.utils.FileFormat;
31  import org.orekit.files.ccsds.utils.generation.AbstractMessageWriter;
32  import org.orekit.files.ccsds.utils.generation.Generator;
33  import org.orekit.time.AbsoluteDate;
34  import org.orekit.utils.IERSConventions;
35  
36  
37  /**
38   * Writer for CCSDS Orbit Parameter Message.
39   *
40   * @author Luc Maisonobe
41   * @since 11.0
42   */
43  public class ApmWriter extends AbstractMessageWriter<Header, Segment<AdmMetadata, ApmData>, Apm> {
44  
45      /** Version number implemented. **/
46      public static final double CCSDS_APM_VERS = 1.0;
47  
48      /** Padding width for aligning the '=' sign. */
49      public static final int KVN_PADDING_WIDTH = 17;
50  
51      /** Complete constructor.
52       * <p>
53       * Calling this constructor directly is not recommended. Users should rather use
54       * {@link org.orekit.files.ccsds.ndm.WriterBuilder#buildApmWriter()
55       * writerBuilder.buildOpmWriter()}.
56       * </p>
57       * @param conventions IERS Conventions
58       * @param dataContext used to retrieve frames, time scales, etc.
59       * @param missionReferenceDate reference date for Mission Elapsed Time or Mission Relative Time time systems
60       */
61      public ApmWriter(final IERSConventions conventions, final DataContext dataContext,
62                       final AbsoluteDate missionReferenceDate) {
63          super(Apm.ROOT, Apm.FORMAT_VERSION_KEY, CCSDS_APM_VERS,
64                new ContextBinding(
65                    () -> conventions,
66                    () -> false, () -> dataContext, () -> ParsedUnitsBehavior.STRICT_COMPLIANCE,
67                    () -> missionReferenceDate, () -> TimeSystem.UTC,
68                    () -> 0.0, () -> 1.0));
69      }
70  
71      /** {@inheritDoc} */
72      @Override
73      public void writeSegmentContent(final Generator generator, final double formatVersion,
74                                      final Segment<AdmMetadata, ApmData> segment)
75          throws IOException {
76  
77          // write the metadata
78          final ContextBinding oldContext = getContext();
79          final AdmMetadata    metadata   = segment.getMetadata();
80          setContext(new ContextBinding(oldContext::getConventions,
81                                        oldContext::isSimpleEOP,
82                                        oldContext::getDataContext,
83                                        oldContext::getParsedUnitsBehavior,
84                                        oldContext::getReferenceDate,
85                                        metadata::getTimeSystem,
86                                        oldContext::getClockCount,
87                                        oldContext::getClockRate));
88          new AdmMetadataWriter(metadata).write(generator);
89  
90          // start data block
91          if (generator.getFormat() == FileFormat.XML) {
92              generator.enterSection(XmlStructureKey.data.name());
93          }
94  
95          generator.writeComments(segment.getData().getComments());
96  
97          // write mandatory quaternion block
98          new ApmQuaternionWriter(XmlSubStructureKey.quaternionState.name(), null,
99                                  segment.getData().getQuaternionBlock(), getTimeConverter()).
100         write(generator);
101 
102         if (segment.getData().getEulerBlock() != null) {
103             // write optional Euler block for three axis stabilized satellites
104             new EulerWriter(XmlSubStructureKey.eulerElementsThree.name(), null,
105                             segment.getData().getEulerBlock()).
106             write(generator);
107         }
108 
109         if (segment.getData().getSpinStabilizedBlock() != null) {
110             // write optional Euler block for spin stabilized satellites
111             new SpinStabilizedWriter(XmlSubStructureKey.eulerElementsSpin.name(), null,
112                                      segment.getData().getSpinStabilizedBlock()).
113             write(generator);
114         }
115 
116         if (segment.getData().getSpacecraftParametersBlock() != null) {
117             // write optional spacecraft parameters block
118             new SpacecraftParametersWriter(XmlSubStructureKey.spacecraftParameters.name(), null,
119                                            segment.getData().getSpacecraftParametersBlock()).
120             write(generator);
121         }
122 
123         if (!segment.getData().getManeuvers().isEmpty()) {
124             for (final Maneuver maneuver : segment.getData().getManeuvers()) {
125                 // write optional maneuver block
126                 new ManeuverWriter(XmlSubStructureKey.maneuverParameters.name(), null,
127                                    maneuver, getTimeConverter()).write(generator);
128             }
129         }
130 
131         // stop data block
132         if (generator.getFormat() == FileFormat.XML) {
133             generator.exitSection();
134         }
135 
136     }
137 
138 }