Compare revisions

4d9222bb · 1e348e49 · 3b78ccfd · cab1163c · ae789c8d · 395dcb4b
--- a/.CI/README
+++ b/.CI/README
+A directory for Continuous Integration tooling.
\ No newline at end of file
--- a/.CI/maven-settings.xml
+++ b/.CI/maven-settings.xml
+<settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+          xsi:schemalocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
+    <mirrors>
+        <!-- mirror
+        | Specifies a repository mirror site to use instead of a given repository. The repository that
+        | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
+        | for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
+        |
+        <mirror>
+        <id>mirrorId</id>
+        <mirrorOf>repositoryId</mirrorOf>
+        <name>Human Readable Name for this Mirror.</name>
+        <url>http://my.repository.com/repo/path</url>
+        </mirror>
+        -->
+        <mirror>
+            <id>Nexus-Rugged</id>
+            <name>Maven Repository Manager</name>
+            <!-- Share the same Nexus repository as Orekit -->
+            <url>https://packages.orekit.org/repository/maven-public/</url>
+            <mirrorOf>*</mirrorOf>
+        </mirror>
+    </mirrors>
+    <servers>
+        <server>
+            <id>ci-releases</id>
+            <username>${env.NEXUS_USERNAME}</username>
+            <password>${env.NEXUS_PASSWORD}</password>
+        </server>
+        <server>
+            <id>ci-snapshots</id>
+            <username>${env.NEXUS_USERNAME}</username>
+            <password>${env.NEXUS_PASSWORD}</password>
+        </server>
+        <server>
+            <id>website</id>
+            <privateKey>${user.home}/.ssh/id_website</privateKey>
+        </server>
+    </servers>
+    <profiles>
+        <profile>
+            <activation>
+                <activeByDefault>true</activeByDefault>
+            </activation>
+            <repositories>
+                <repository>
+                    <id>Nexus-Rugged</id>
+                    <name>Nexus Public Repository</name>
+                    <!-- Share the same Nexus repository as Orekit -->
+                    <url>https://packages.orekit.org/repository/maven-public/</url>
+                    <releases>
+                        <enabled>true</enabled>
+                    </releases>
+                    <snapshots>
+                        <enabled>true</enabled>
+                        <updatePolicy>always</updatePolicy>
+                    </snapshots>
+                </repository>
+            </repositories>
+        </profile>
+    </profiles>
+</settings>
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
+stages:
+- verify
+- deploy
+
+default:
+  # Default image
+  image: registry.orekit.org/orekit/ci-utils/maven:3.3.9-jdk-8
+  # Cache downloaded dependencies and plugins between builds.
+  # To keep cache across branches add 'key: "$CI_JOB_REF_NAME"'
+  cache:
+    paths:
+      - .m2/repository
+
+variables:
+  # This will supress any download for dependencies and plugins or upload messages which would clutter the console log.
+  # `showDateTime` will show the passed time in milliseconds. You need to specify `--batch-mode` to make this work.
+  MAVEN_OPTS: "-Dmaven.repo.local=.m2/repository -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=WARN -Dorg.slf4j.simpleLogger.showDateTime=true -Djava.awt.headless=true"
+  # As of Maven 3.3.0 instead of this you may define these options in `.mvn/maven.config` so the same config is used
+  # when running from the command line.
+  # `installAtEnd` and `deployAtEnd` are only effective with recent version of the corresponding plugins.
+  MAVEN_CLI_OPTS: "-s .CI/maven-settings.xml --batch-mode --errors --fail-at-end --show-version -DinstallAtEnd=true -DdeployAtEnd=true"
+
+verify:
+  stage: verify
+  script:
+    - mvn $MAVEN_CLI_OPTS verify site
+    - mvn $MAVEN_CLI_OPTS sonar:sonar -Dsonar.login=${SONAR_TOKEN} -Dsonar.branch.name=${CI_COMMIT_REF_NAME}
+  artifacts:
+    paths:
+      - target/*.jar
+      - target/site
+    reports:
+      junit:
+        - target/surefire-reports/*.xml
+
+# On main branches (develop, release-*, master)
+# the produced artifacts are deployed on the Nexus of the project
+# (https://packages.orekit.org/)
+deploy:artifacts:
+  stage: deploy
+  script:
+    - mvn $MAVEN_CLI_OPTS javadoc:jar source:jar deploy -DskipTests=true -Pci-deploy
+  artifacts:
+    paths:
+      - target/*.jar
+  only:
+    - develop@orekit/rugged
+    - /^release-[.0-9]+$/@orekit/rugged
+    - master@orekit/rugged
+
+
+deploy:site:
+  stage: deploy
+  before_script:
+  ##
+  ## Create the SSH directory and give it the right permissions
+  ##
+  - mkdir -p ~/.ssh
+  - chmod 700 ~/.ssh
+
+  ##
+  ## We're using tr to fix line endings which makes ed25519 keys work
+  ## without extra base64 encoding.
+  ## https://gitlab.com/gitlab-examples/ssh-private-key/issues/1#note_48526556
+  ##
+  - echo "$SSH_SECRET_KEY" > ~/.ssh/id_website
+  - chmod 700 ~/.ssh/id_website
+  
+  ##
+  ## Add known hosts
+  ##
+  - cp $SSH_KNOWN_HOSTS ~/.ssh/known_hosts
+  script:
+  - mvn $MAVEN_CLI_OPTS site:deploy
+  only:
+  - master@orekit/rugged
+  - /^release-[.0-9]+$/@orekit/rugged
+  - develop@orekit/rugged
--- a/BUILDING.txt
+++ b/BUILDING.txt
-Rugged can be built from source either using maven 3 or eclipse.
-
-Building with Maven 3:
- - Maven 3 can be downloaded here:
-       http://maven.apache.org/download.html
- - If you are behind a proxy (which is a traditional
-   setting in a corporate environment), then you need
-   to configure maven to use it. This is explained
-   in the maven documentation here:
-   http://maven.apache.org/guides/mini/guide-proxies.html
- - run "mvn package" to automatically download all
-   the required dependencies listed in the pom.xml file
-   and create a file named target/rugged-x.y.jar where
-   x.y is the version number
-
-Building with Eclipse:
- - Eclipse can be downloaded here:
-       http://www.eclipse.org/downloads/
- - extract the rugged source jar in your eclipse workspace
- - create a new java project from existing sources and direct
-   Eclipse to the directory where you unpacked Rugged
- - set the source folders to rugged/src/main/java,
-   rugged/src/main/resources, rugged/src/test/java,
-   rugged/src/test/resources in
-   the source tab of the Configure Build Path dialog
- - set the external libraries to JRE system library (provided by Eclipse),
-   Junit 4.x (provided by Eclipse) orekit (available at Orekit website
-   https://www.orekit.org/) and Hipparchus (available at
-    Hipparchus project downloads page https://www.hipparchus.org/downloads.html)
-   in the libraries tab of the Configure Build Path dialog
-
--- a/NOTICE.txt
+++ b/NOTICE.txt
 RUGGED
-Copyright 2013-2016 CS Systèmes d'Information
+Copyright 2013-2022 CS GROUP

 This product includes software developed by
-CS Systèmes d'Information (http://www.c-s.fr/)
+CS GROUP (https://www.csgroup.eu/)

 This product depends on software developed by
 The Apache Software Foundation (http://www.apache.org/)
+
+This product depends on software developed by
+The Hipparchus project (https://hipparchus.org/)
--- a/Readme.md
+++ b/Readme.md
+![Rugged logo](https://www.orekit.org/rugged/img/rugged-logo-small.jpg)
+
+# Rugged
+
+> A sensor-to-terrain mapping tool
+
+[Rugged](https://www.orekit.org/rugged/  "Rugged homepage") is a free java library for geolocation and used for satellite imagery.
+
+Rugged is an add-on for [Orekit](https://www.orekit.org/ "Orekit homepage") handling Digital Elevation Models contribution to line of sight computation. It is a free software intermediate-level library written in Java.
+
+It mainly provides direct and inverse location, i.e. it allows to compute accurately 
+which ground point is looked at from a specific pixel in a spacecraft instrument, 
+and conversely which pixel will see a specified ground point. This mapping between 
+ground and sensor is computed with a viewing model taking into account:
+* ground Digital Elevation Model (DEM), 
+* Earth rotation will all its tiny irregularities, 
+* on-board sensor pixels individual line-of-sights, 
+* spacecraft motion and attitude,
+* several physical effects.
+
+Direct and inverse location can be used to perform full ortho-rectification of 
+images and correlation between sensors observing the same area.
+
+
+[![](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
+[![](https://sonar.orekit.org/api/project_badges/measure?project=org.orekit%3Arugged&metric=alert_status)](https://sonar.orekit.org/dashboard?id=org.orekit%3Arugged)
+[![](https://sonar.orekit.org/api/project_badges/measure?project=org.orekit%3Arugged&metric=coverage)](https://sonar.orekit.org/component_measures?id=org.orekit%3Arugged&metric=coverage&view=treemap)
+
+## Download
+
+### Official releases
+
+[Official Rugged releases](https://gitlab.orekit.org/orekit/rugged/-/releases)
+are available on our [Gitlab instance](https://gitlab.orekit.org/orekit/rugged). They are
+also available in the
+[Maven repository](https://mvnrepository.com/artifact/org.orekit/rugged).
+
+### Development version
+
+To get the latest development version, please clone our official repository
+and checkout the `develop` branch:
+
+```bash
+git clone -b develop https://gitlab.orekit.org/orekit/rugged.git
+```
+__Note:__ Our official repository is
+[mirrored on Github](https://github.com/CS-SI/Rugged).
+
+## Documentation
+
+Project overview, architecture and development, detailed features list,
+Javadoc and a lot of other information is available on the
+[Maven site](https://www.orekit.org/site-rugged-development/).
+
+## Getting help
+
+The main communication channel is our [forum](https://forum.orekit.org/). You
+can report bugs and suggest new features in our
+[issues tracking system](https://gitlab.orekit.org/orekit/rugged/-/issues). When
+reporting security issues check the "This issue is confidential" box.
+
+## Contributing
+
+Please take a look at our
+[contributing guidelines](https://www.orekit.org/site-rugged-latest/contributing.html) if you're
+interested in helping!
+
+## Building
+
+Detailed information on how to build Rugged from source either using Maven or
+Eclipse is provided in [building](https://www.orekit.org/site-rugged-latest/building.html) explanations.
+
+## Dependencies
+
+Rugged relies on the following
+[FOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) libraries,
+all released under business friendly FOSS licenses.
+
+### Compile-time/run-time dependencies
+
+* [Orekit](https://www.orekit.org/), a low level space dynamics library released under
+  the Apache License, version 2.0.
+
+* [Hipparchus](https://hipparchus.org/), a mathematics library released under
+  the Apache License, version 2.0.
+
+### Test-time dependencies
+
+* [JUnit 4](http://www.junit.org/), a widely used unit test framework released
+  under the Eclipse Public License, version 1.0.
+
+More detailed information is available in the
+[Maven site](https://www.orekit.org/site-rugged-development/dependencies.html).
+
+## License
+
+Rugged is licensed by [CS GROUP](https://www.csgroup.eu/) under
+the [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html).
+A copy of this license is provided in the [LICENSE.txt](LICENSE.txt) file.
--- a/checkstyle.xml
+++ b/checkstyle.xml
 <?xml version="1.0"?>
-<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.2//EN"
-                        "http://www.puppycrawl.com/dtds/configuration_1_2.dtd">
+<!DOCTYPE module PUBLIC
+   "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+   "https://checkstyle.org/dtds/configuration_1_3.dtd">

 <module name="Checker">
    <module name="TreeWalker">
@@ -31,11 +32,10 @@
        <module name="IllegalImport"/>
        <module name="Indentation">
            <property name="basicOffset" value="4"/>
-            <property name="caseIndent" value="0"/>
+            <property name="caseIndent"  value="4"/>
        </module>
        <module name="JavadocMethod">
-            <property name="allowUndeclaredRTE" value="true"/>
-            <property name="allowMissingPropertyJavadoc" value="true"/>
+            <property name="validateThrows" value="false"/>
        </module>
        <module name="JavadocStyle"/>
        <module name="JavadocVariable"/>
@@ -70,36 +70,37 @@
                             PLUS_ASSIGN, QUESTION, RCURLY, SL, SLIST, SL_ASSIGN, SR,
                             SR_ASSIGN, STAR, STAR_ASSIGN"/>
        </module>
-        <module name="FileContentsHolder"/>
+        <module name="SuppressionCommentFilter">
+           <property name="offCommentFormat" value="CHECKSTYLE\: stop JavadocVariable check"/>
+            <property name="onCommentFormat"  value="CHECKSTYLE\: resume JavadocVariable check"/>
+            <property name="checkFormat"      value="JavadocVariable"/>
+        </module>
+        <module name="SuppressionCommentFilter">
+            <property name="offCommentFormat" value="CHECKSTYLE\: stop VisibilityModifier check"/>
+            <property name="onCommentFormat"  value="CHECKSTYLE\: resume VisibilityModifier check"/>
+            <property name="checkFormat"      value="VisibilityModifierCheck"/>
+        </module>
+        <module name="SuppressionCommentFilter">
+            <property name="offCommentFormat" value="CHECKSTYLE\: stop NoWhitespaceAfter check"/>
+            <property name="onCommentFormat"  value="CHECKSTYLE\: resume NoWhitespaceAfter check"/>
+            <property name="checkFormat"      value="NoWhitespaceAfter"/>
+        </module>
+        <module name="SuppressionCommentFilter">
+          <property name="offCommentFormat" value="CHECKSTYLE\: stop Indentation check"/>
+          <property name="onCommentFormat" value="CHECKSTYLE\: resume Indentation check"/>
+          <property name="checkFormat" value="IndentationCheck"/>
+        </module>
+        <module name="SuppressionCommentFilter">
+          <property name="offCommentFormat" value="CHECKSTYLE\: stop MultipleStringLiterals check"/>
+          <property name="onCommentFormat" value="CHECKSTYLE\: resume MultipleStringLiterals check"/>
+          <property name="checkFormat" value="MultipleStringLiteralsCheck"/>
+        </module>
    </module>
    <module name="RegexpHeader">
      <property name="headerFile" value="${checkstyle.header.file}" />
    </module>
    <module name="FileTabCharacter"/>
-    <module name="NewlineAtEndOfFile"/>
-    <module name="SuppressionCommentFilter">
-        <property name="offCommentFormat" value="CHECKSTYLE\: stop JavadocVariable check"/>
-        <property name="onCommentFormat"  value="CHECKSTYLE\: resume JavadocVariable check"/>
-        <property name="checkFormat"      value="JavadocVariable"/>
-    </module>
-    <module name="SuppressionCommentFilter">
-        <property name="offCommentFormat" value="CHECKSTYLE\: stop VisibilityModifierCheck"/>
-        <property name="onCommentFormat"  value="CHECKSTYLE\: resume VisibilityModifierCheck"/>
-        <property name="checkFormat"      value="VisibilityModifierCheck"/>
-    </module>
-    <module name="SuppressionCommentFilter">
-        <property name="offCommentFormat" value="CHECKSTYLE\: stop NoWhitespaceAfter"/>
-        <property name="onCommentFormat"  value="CHECKSTYLE\: resume NoWhitespaceAfter"/>
-        <property name="checkFormat"      value="NoWhitespaceAfter"/>
-    </module>
-    <module name="SuppressionCommentFilter">
-    	<property name="offCommentFormat" value="CHECKSTYLE\: stop FallThrough check"/>
-    	<property name="onCommentFormat" value="CHECKSTYLE\: resume FallThrough check"/>
-    	<property name="checkFormat" value="FallThrough"/>
-  	</module>
-    <module name="SuppressionCommentFilter">
-      <property name="offCommentFormat" value="CHECKSTYLE\: stop HiddenField check"/>
-      <property name="onCommentFormat" value="CHECKSTYLE\: resume HiddenField check"/>
-      <property name="checkFormat" value="HiddenField"/>
-    </module>
+    <module name="NewlineAtEndOfFile">
+	  <property name="lineSeparator" value="LF_CR_CRLF"/>
+	</module>
 </module>
--- a/findbugs-exclude-filter.xml
+++ b/findbugs-exclude-filter.xml
-<?xml version="1.0"?>
-<!--
-  This file contains some false positive bugs detected by findbugs. Their
-  false positive nature has been analyzed individually and they have been
-  put here to instruct findbugs it must ignore them.
-->
-<FindBugsFilter>
-
-</FindBugsFilter>
--- a/pom.xml
+++ b/pom.xml
--- a/spotbugs-exclude-filter.xml
+++ b/spotbugs-exclude-filter.xml
+<?xml version="1.0"?>
+<!--
+  This file contains some false positive bugs detected by spotbugs. Their
+  false positive nature has been analyzed individually and they have been
+  put here to instruct findbugs it must ignore them.
+-->
+<FindBugsFilter>
+
+  <!-- The following internal representation exposure are intentional,
+       They are used to pass data back and forth between classes
+    -->
+  <Match>
+    <Class name="org.orekit.rugged.adjustment.AdjustmentContext"/>
+    <Method name="&lt;init>"
+            params="java.util.Collection,
+                    org.orekit.rugged.adjustment.measurements.Observables"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.adjustment.GroundOptimizationProblemBuilder"/>
+    <Method name="&lt;init>"
+            params="java.util.List,org.orekit.rugged.adjustment.measurements.Observables,
+                    org.orekit.rugged.api.Rugged"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.adjustment.measurements.SensorToSensorMapping"/>
+    <Or>
+      <Method name="getBodyDistances"
+              params=""
+              returns="java.util.List" />
+      <Method name="getLosDistances"
+              params=""
+              returns="java.util.List" />
+    </Or>
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.api.Rugged"/>
+    <Or>
+      <Method name="getEllipsoid"
+              params=""
+              returns="org.orekit.rugged.utils.ExtendedEllipsoid" />
+      <Method name="getRefractionCorrection"
+              params=""
+              returns="org.orekit.rugged.refraction.AtmosphericRefraction" />
+    </Or>
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.api.RuggedBuilder"/>
+    <Or>
+      <Method name="getEllipsoid"
+              params=""
+              returns="org.orekit.rugged.utils.ExtendedEllipsoid" />
+      <Method name="getPositionsVelocities"
+              params=""
+              returns="java.util.List" />
+      <Method name="getQuaternions"
+              params=""
+              returns="java.util.List" />
+      <Method name="getRefractionCorrection"
+              params=""
+              returns="org.orekit.rugged.refraction.AtmosphericRefraction" />
+    </Or>
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.api.RuggedBuilder"/>
+    <Or>
+      <Method name="setRefractionCorrection"
+              params="org.orekit.rugged.refraction.AtmosphericRefraction"
+              returns="org.orekit.rugged.api.RuggedBuilder" />
+      <Method name="setTrajectory"
+              params="double,
+                      int,
+                      org.orekit.utils.CartesianDerivativesFilter,
+                      org.orekit.utils.AngularDerivativesFilter,
+                      org.orekit.propagation.Propagator"
+              returns="org.orekit.rugged.api.RuggedBuilder" />
+      <Method name="setTrajectory"
+              params="org.orekit.frames.Frame,
+                      java.util.List,
+                      int,
+                      org.orekit.utils.CartesianDerivativesFilter,
+                      java.util.List,
+                      int,
+                      org.orekit.utils.AngularDerivativesFilter"
+              returns="org.orekit.rugged.api.RuggedBuilder" />
+    </Or>
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.errors.RuggedExceptionWrapper"/>
+    <Method name="getException"
+            params=""
+            returns="org.orekit.rugged.errors.RuggedException" />
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.errors.RuggedExceptionWrapper"/>
+    <Method name="&lt;init>"
+            params="org.orekit.rugged.errors.RuggedException"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.linesensor.LineSensor"/>
+    <Method name="getPosition"
+            params=""
+            returns="org.hipparchus.geometry.euclidean.threed.Vector3D" />
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.linesensor.LineSensor"/>
+    <Method name="&lt;init>"
+            params="java.lang.String,
+                    org.orekit.rugged.linesensor.LineDatation,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D,
+                    org.orekit.rugged.los.TimeDependentLOS"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.linesensor.SensorMeanPlaneCrossing"/>
+    <Method name="getMeanPlaneNormal"
+            params=""
+            returns="org.hipparchus.geometry.euclidean.threed.Vector3D" />
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.linesensor.SensorMeanPlaneCrossing"/>
+    <Method name="&lt;init>"
+            params="org.orekit.rugged.linesensor.LineSensor,
+                    org.orekit.rugged.utils.SpacecraftToObservedBody,
+                    int,
+                    int,
+                    boolean,
+                    boolean,
+                    int,
+                    double,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D,
+                    java.util.stream.Stream"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.linesensor.SensorMeanPlaneCrossing$CrossingResult"/>
+    <Or>
+      <Method name="getTarget"
+              params=""
+              returns="org.hipparchus.geometry.euclidean.threed.Vector3D" />
+      <Method name="getTargetDirection"
+              params=""
+              returns="org.hipparchus.geometry.euclidean.threed.Vector3D" />
+      <Method name="getTargetDirectionDerivative"
+              params=""
+              returns="org.hipparchus.geometry.euclidean.threed.Vector3D" />
+    </Or>
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.linesensor.SensorMeanPlaneCrossing$CrossingResult"/>
+    <Method name="&lt;init>"
+            params="org.orekit.time.AbsoluteDate,
+                    double,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.los.FixedRotation"/>
+    <Method name="&lt;init>"
+            params="java.lang.String,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D,double"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.los.LOSBuilder"/>
+    <Method name="&lt;init>"
+            params="java.util.List"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.los.PolynomialRotation"/>
+    <Method name="&lt;init>"
+            params="java.lang.String,
+                    org.hipparchus.geometry.euclidean.threed.Vector3D,
+                    org.orekit.time.AbsoluteDate,
+                    double[]"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.refraction.AtmosphericRefraction"/>
+    <Method name="getComputationParameters"
+            params=""
+            returns="org.orekit.rugged.refraction.AtmosphericComputationParameters" />
+    <Bug pattern="EI_EXPOSE_REP" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.refraction.MultiLayerModel"/>
+    <Or>
+      <Method name="&lt;init>"
+              params="org.orekit.rugged.utils.ExtendedEllipsoid"
+              returns="void" />
+      <Method name="&lt;init>"
+              params="org.orekit.rugged.utils.ExtendedEllipsoid,
+                      java.util.List"
+              returns="void" />
+    </Or>
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.utils.RoughVisibilityEstimator"/>
+    <Method name="&lt;init>"
+            params="org.orekit.bodies.OneAxisEllipsoid,
+                    org.orekit.frames.Frame,java.util.List"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+  <Match>
+    <Class name="org.orekit.rugged.utils.SpacecraftToObservedBody"/>
+    <Method name="&lt;init>"
+            params="org.orekit.frames.Frame,
+                    org.orekit.frames.Frame,
+                    org.orekit.time.AbsoluteDate,
+                    org.orekit.time.AbsoluteDate,
+                    double,
+                    double,
+                    java.util.List,
+                    java.util.List"
+            returns="void" />
+    <Bug pattern="EI_EXPOSE_REP2" />
+  </Match>
+
+</FindBugsFilter>
--- a/src/assembly/binary-assembly.xml
+++ b/src/assembly/binary-assembly.xml
-<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
-  <id>bin</id>
-  <formats>
-    <format>zip</format>
-  </formats>
-  <componentDescriptors>
-    <componentDescriptor>src/assembly/misc-files.xml</componentDescriptor>
-    <componentDescriptor>src/assembly/jar-files.xml</componentDescriptor>
-  </componentDescriptors>
-</assembly>
\ No newline at end of file
--- a/src/assembly/building-files.xml
+++ b/src/assembly/building-files.xml
-<component>
-  <fileSets>
-    <fileSet>
-      <includes>
-        <include>BUILDING.txt</include>
-        <include>pom.xml</include>
-        <include>checkstyle.xml</include>
-        <include>findbugs-exclude-filter.xml</include>
-        <include>license-header.txt</include>
-      </includes>
-      <useDefaultExcludes>true</useDefaultExcludes>
-    </fileSet>
-    <fileSet>
-      <directory>src</directory>
-      <useDefaultExcludes>true</useDefaultExcludes>
-    </fileSet>
-  </fileSets>
-</component>
\ No newline at end of file
--- a/src/assembly/jar-files.xml
+++ b/src/assembly/jar-files.xml
-<component>
-  <fileSets>
-    <fileSet>
-      <directory>target</directory>
-      <outputDirectory></outputDirectory>
-      <includes>
-        <include>*.jar</include>
-      </includes>
-    </fileSet>
-  </fileSets>
-</component>
\ No newline at end of file
--- a/src/assembly/misc-files.xml
+++ b/src/assembly/misc-files.xml
-<component>
-  <fileSets>
-    <fileSet>
-      <includes>
-       <include>LICENSE.txt</include>
-       <include>NOTICE.txt</include>
-      </includes>
-    </fileSet>
-  </fileSets>
-</component>
--- a/src/assembly/source-assembly.xml
+++ b/src/assembly/source-assembly.xml
-<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
-  <id>sources</id>
-  <formats>
-    <format>zip</format>
-  </formats>
-  <componentDescriptors>
-    <componentDescriptor>src/assembly/misc-files.xml</componentDescriptor>
-    <componentDescriptor>src/assembly/building-files.xml</componentDescriptor>
-  </componentDescriptors>
-</assembly>
\ No newline at end of file
--- a/src/site/xdoc/changes.xml
+++ b/src/site/xdoc/changes.xml
 <?xml version="1.0" encoding="UTF-8" ?>
-<!-- Copyright 2013-2016 CS Systèmes d'Information
-  Licensed to CS Systèmes d'Information (CS) under one or more
+<!-- Copyright 2013-2022 CS GROUP
+  Licensed to CS GROUP (CS) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  CS licenses this file to You under the Apache License, Version 2.0
@@ -20,7 +20,162 @@
    <title>Rugged Changes</title>
  </properties>
  <body>
-    <release version="2.0" date="TBD" description="TTBD">
+    <release version="3.0" date="2022-07-05" description="This is a major release.
+    It fixes a few bugs.
+    This version depends on Orekit 11.2 and Hipparchus 2.1.">
+      <action dev="luc" type="update" issue="388">
+        Fixed longitude normalization issue with tiles.
+      </action>
+      <action dev="guylaine" type="update" issue="391">
+        Fixed inverse location issue with atmospheric refraction.
+      </action>
+      <action dev="luc" type="update" issue="387">
+        Updated dependencies to Orekit 11.2 (and Hipparchus 2.1 ).
+      </action>
+      <action dev="guylaine" type="update" issue="390">
+        Changed CS Group website URL.
+      </action>
+      <action dev="guylaine" type="update">
+        Updated link to Sergeï Tanygin's paper about attitude interpolation in documentation.
+      </action>
+    </release>
+    <release version="2.2" date="2020-07-31" description="This is a minor release.
+     It adds access to algorithm identifier, 
+     corrects an Earth constant for model IERS96, 
+     improves documentation and fixes a few bugs.
+     Automatic building, release and code analysis are available with Gitlab CI.
+     This version depends on Orekit 10.2 and Hipparchus 1.7.">
+      <action dev="guylaine" type="update" issue="383">
+        Updated dependencies to Orekit 10.2 (and Hipparchus 1.7).
+      </action>
+      <action dev="guylaine" type="fix" issue="384">
+        Add connection with Gitlab CI to allow automatic building and release,
+        as well as automatic code analysis (https://sonar.orekit.org/dashboard?id=org.orekit%3Arugged).
+      </action>
+      <action dev="luc" type="fix" issue="386">
+        Fix a unit test due to CI specificity.
+      </action>
+      <action dev="guylaine" type="update"  issue="381">
+        Give access to algorithm identifier (DUVENHAGE,
+        CONSTANT_ELEVATION_OVER_ELLIPSOID, ...) with the new method getAlgorithmId().
+      </action>
+      <action dev="guylaine" type="update"  issue="385">
+        Use the new Derivative&lt;T&gt; interface from Hipparchus.
+      </action>
+       <action dev="guylaine" type="fix" issue="379">
+        Correct erroneous Earth flattening for model IERS96 in RuggedBuilder.
+      </action>
+      <action dev="guylaine" type="update" issue="378">
+        Replace in RuggedBuilder hard-coded constants by Orekit Earth constants.
+      </action>
+      <action dev="guylaine" type="update">
+        Update building explanations in static site and remove redundant BUILDING.txt.
+      </action>
+      <action dev="guylaine" type="add">
+        Create a release guide in static site.
+      </action>
+      <action dev="guylaine" type="update">
+        Update deprecated method of Orekit DataProvidersManager class.
+      </action>
+      <action dev="guylaine" type="update" issue="382">
+        Remove explicit dependency to Hipparchus library.
+      </action>
+      <action dev="guylaine" type="add">
+        Add package-info documentation.
+      </action>
+     </release>
+     
+     <release version="2.1" date="2019-03-14" description="This is a minor release.
+     It adds refraction in inverse location and fixes a few bugs. This version depends
+     on Orekit 9.3.1 and Hipparchus 1.4.">
+      <action dev="guylaine" type="update">
+        Updated dependencies to Orekit 9.3.1 and Hipparchus 1.4.
+      </action>
+      <action dev="luc" type="fix" issue="376">
+        Direct location may result to a null result in some very rugged region.
+        In Duvenhage algorithm, in the refineIntersection method for the DEM, 
+        some rare cases led to no intersection (as a result from SimpleTile.cellIntersection) 
+        with the closeGuess given as input of refineIntersection.By shifting the solution 
+        along the LOS direction, with an iterative process, we are able to find the intersection.
+      </action>
+      <action dev="guylaine" type="fix" issue="377">
+        Add the possibility to suspend and resume the dump.
+        When performing a dump, in some cases, some extra informations are dumped 
+        but are not relevant. 
+        For instance when updating a tile for a SRTM tile, we need to add the geoid
+        value of the current point. In the dump file, the geoid tile is also dumped
+        and it leads to bad results when performing the DumpReplayer, as the geoid 
+        elevations are read instead of the real elevations.
+      </action>
+      <action dev="guylaine" type="update">
+        Enable null in dump of direct or inverse location results.
+        If direct or inverse location gave "null" as a result, it was not dumped.
+      </action>
+      <action dev="guylaine" type="update">
+        Improve test coverage of classes related to dump (org.orekit.rugged.errors).
+      </action>
+      <action dev="guylaine" type="fix" issue="373">
+        Changed RuggedException from checked to unchecked exception.
+        Most functions do throw such exceptions. As they are unchecked, they are
+        not advertised in either `throws` statements in the function signature or
+        in the javadoc. So users must consider that as soon as they use any Rugged
+        feature, an unchecked `RuggedException` may be thrown. In most cases, users
+        will not attempt to recover for this but will only use them to display or
+        log a meaningful error message.
+      </action>
+      <action dev="guylaine" type="fix" issue="372">
+        Add (optional) atmospheric refraction for inverse location. 
+        In Rugged 2.0, only the direct location can take into account the atmospheric refraction.
+      </action>
+      <action dev="guylaine" type="add" due-to="Issam Boukerch">
+        Changed terms for refining tutorials.
+        The "fulcrum points" term is changed into "Ground Control Points (GCP)" and 
+        the "liaison points" term into "tie points".
+      </action>
+       <action dev="luc" type="fix" issue="371">
+        For refining computation, correct the constructor of the class 
+        adjustment.measurements.SensorToGroundMapping due to a parameters reversal error.
+      </action>
+      <action dev="guylaine" type="fix" issue="256">
+        Bad check of maxDate validity in utils.SpacecraftToObservedBody.SpacecraftToObservedBody
+        method.
+      </action>
+           
+      <action dev="luc" type="add" due-to="Lars Næsbye Christensen">
+        Updated Danish translations of error messages.
+      </action>
+      <action dev="luc" type="add" due-to="Roberto Alacevich">
+        Updated Italian translations of error messages.
+      </action>
+      <action dev="guylaine" type="add" due-to="Espen Bjørntvedt">
+        Updated Norwegian translations of error messages.
+      </action>
+      <action dev="luc" type="add" due-to="Beatriz Salazar García">
+        Updated Spanish translations of error messages.
+      </action>
+      
+    </release>
+      
+    <release version="2.0" date="2017-12-19" description="This is a major release.
+      It mainly provides a refinement feature (i.e. adjusting the viewing model
+      parameters to match ground control points.">
+      <action dev="guylaine" type="update">
+        Updated dependencies to Orekit 9.1 and Hipparchus 1.2.
+      </action>
+      <action dev="guylaine" type="add" due-to="Jonathan Guinet, Lucie Labat-Allée">
+        Added refinement feature, to adjust viewing model parameters
+      </action>
+      <action dev="luc" type="add" due-to="Lars Næsbye Christensen" issue="343">
+        Added Danish translations.
+      </action>
+      <action dev="luc" type="update">
+        Updated dependency to Hipparchus 1.1, released on 2017, March 16th.
+      </action>
+      <action dev="luc" type="add" due-to="Sergio Esteves">
+        Added atmospheric refraction.
+        This work was done under the frame of ESA SOCIS 2016 program.
+        Implements feature #185.
+      </action>
      <action dev="luc" type="update">
        Replaced the ad-hoc parameters with Orekit ParameterDriver that are
        used in Orekit orbit determination feature.

--- a/design/dem-loading-class-diagram.puml
+++ b/design/dem-loading-class-diagram.puml
-' Copyright 2013-2015 CS Systèmes d'Information
-' Licensed to CS Systèmes d'Information (CS) under one or more
+' Copyright 2013-2022 CS GROUP
+' Licensed to CS GROUP (CS) under one or more
 ' contributor license agreements.  See the NOTICE file distributed with
 ' this work for additional information regarding copyright ownership.
 ' CS licenses this file to You under the Apache License, Version 2.0

--- a/design/direct-location-class-diagram.puml
+++ b/design/direct-location-class-diagram.puml
-' Copyright 2013-2015 CS Systèmes d'Information
-' Licensed to CS Systèmes d'Information (CS) under one or more
+' Copyright 2013-2022 CS GROUP
+' Licensed to CS GROUP (CS) under one or more
 ' contributor license agreements.  See the NOTICE file distributed with
 ' this work for additional information regarding copyright ownership.
 ' CS licenses this file to You under the Apache License, Version 2.0

--- a/design/direct-location-sequence-diagram.puml
+++ b/design/direct-location-sequence-diagram.puml
-' Copyright 2013-2015 CS Systèmes d'Information
-' Licensed to CS Systèmes d'Information (CS) under one or more
+' Copyright 2013-2022 CS GROUP
+' Licensed to CS GROUP (CS) under one or more
 ' contributor license agreements.  See the NOTICE file distributed with
 ' this work for additional information regarding copyright ownership.
 ' CS licenses this file to You under the Apache License, Version 2.0

--- a/design/duvenhage-inner-recursion-activity-diagram.puml
+++ b/design/duvenhage-inner-recursion-activity-diagram.puml
-' Copyright 2013-2015 CS Systèmes d'Information
-' Licensed to CS Systèmes d'Information (CS) under one or more
+' Copyright 2013-2022 CS GROUP
+' Licensed to CS GROUP (CS) under one or more
 ' contributor license agreements.  See the NOTICE file distributed with
 ' this work for additional information regarding copyright ownership.
 ' CS licenses this file to You under the Apache License, Version 2.0
No results found