From e149137b457e7f351ac97173d16e4349a0777ec0 Mon Sep 17 00:00:00 2001
From: Guylaine Prat <guylaine.prat@c-s.fr>
Date: Fri, 21 Dec 2018 11:57:40 +0100
Subject: [PATCH] Update static site
---
Readme.md | 53 ++++++------------
.../refraction/AtmosphericRefraction.java | 2 +-
src/site/markdown/building.md | 16 ++++--
src/site/markdown/configuration.md | 28 ++++-----
src/site/markdown/contact.md | 26 +++++----
src/site/markdown/contributing.md | 5 +-
src/site/markdown/design/design.md | 6 +-
.../design/digital-elevation-model.md | 6 +-
src/site/markdown/design/overview.md | 11 +++-
src/site/markdown/design/technical-choices.md | 17 ++++--
src/site/markdown/downloads.md | 47 ++++++++--------
src/site/markdown/faq.md | 41 +++++++++-----
src/site/markdown/guidelines.md | 47 +++++++++-------
src/site/markdown/index.md | 38 ++++++++-----
src/site/markdown/sources.md | 44 ++++++++++-----
.../tutorials/direct-location-with-DEM.md | 30 +++++-----
.../markdown/tutorials/direct-location.md | 36 ++++++------
.../markdown/tutorials/inverse-location.md | 8 ++-
src/site/markdown/tutorials/matlab-example.md | 26 +++++++--
.../resources/images/rugged-architecture.odg | Bin 0 -> 14503 bytes
.../resources/images/rugged-architecture.png | Bin 31475 -> 32686 bytes
src/site/site.xml | 3 +-
22 files changed, 283 insertions(+), 207 deletions(-)
create mode 100644 src/site/resources/images/rugged-architecture.odg
diff --git a/Readme.md b/Readme.md
index 2cfd8021..aef43f6f 100644
--- a/Readme.md
+++ b/Readme.md
@@ -1,3 +1,17 @@
+<!--- Copyright 2013-2018 CS Systèmes d'Information
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
<h1 style="color:blue;" align="center">
Rugged
</h1>
@@ -16,7 +30,7 @@
</p>
-Rugged is an add-on for [Orekit](https://www.orekit.org/) handling Digital Elevation Models contribution to
+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
@@ -32,39 +46,4 @@ ground and sensor is computed with a viewing model taking into account:
Direct and inverse location can be used to perform full ortho-rectification of
images and correlation between sensors observing the same area.
-Homepage: [www.orekit.org/rugged/](https://www.orekit.org/rugged/)
-
-
-
-## Introduction
-* [Overview](src/site/markdown/index.md)
-* [Getting the sources](src/site/markdown/sources.md)
-* [Building](src/site/markdown/building.md)
-* [Configuration](src/site/markdown/configuration.md)
-* [FAQ](src/site/markdown/faq.md)
-* [License](LICENSE.txt)
-* [Downloads](src/site/markdown/downloads.md)
-* [`Changes`](src/site/xdoc/changes.xml)
-* [Contact](src/site/markdown/contact.md)
-
-## Design
-
-
-* [Overview](src/site/markdown/design/overview.md)
-* [Technical choices](src/site/markdown/design/technical-choices.md)
-* [Digital Elevation Model](src/site/markdown/design/digital-elevation-model.md)
-* [Design of major functions](src/site/markdown/design/design.md)
-
-## Tutorial
-
-* [Direct location (with Rugged initialization example)](src/site/markdown/tutorials/direct-location.md)
-* [Direct location with DEM](src/site/markdown/tutorials/direct-location-with-DEM.md)
-* [Inverse location](src/site/markdown/tutorials/inverse-location.md)
-* [Example in Matlab](src/site/markdown/tutorials/matlab-example.md)
-
-## Development
-
-* [Contributing](src/site/markdown/contributing.md)
-* [Guidelines](src/site/markdown/guidelines.md)
-* [`Javadoc, development`](https://www.orekit.org/site-rugged-development/apidocs/index.html)
-* [`SOCIS|Summer Of Code In Space (SOCIS)`]()
+Homepage: [www.orekit.org/rugged/](https://www.orekit.org/rugged/ "Rugged homepage")
diff --git a/src/main/java/org/orekit/rugged/refraction/AtmosphericRefraction.java b/src/main/java/org/orekit/rugged/refraction/AtmosphericRefraction.java
index d65c9955..efccaf1d 100644
--- a/src/main/java/org/orekit/rugged/refraction/AtmosphericRefraction.java
+++ b/src/main/java/org/orekit/rugged/refraction/AtmosphericRefraction.java
@@ -26,7 +26,7 @@ import org.orekit.rugged.linesensor.SensorPixel;
import org.orekit.rugged.utils.NormalizedGeodeticPoint;
/**
- * Interface for atmospheric refraction model.
+ * Base class for atmospheric refraction model.
* @author Sergio Esteves
* @author Guylaine Prat
* @since 2.0
diff --git a/src/site/markdown/building.md b/src/site/markdown/building.md
index c40c95eb..7004177f 100644
--- a/src/site/markdown/building.md
+++ b/src/site/markdown/building.md
@@ -12,6 +12,8 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Building Rugged
Rugged can be built from source using several different tools.
@@ -22,7 +24,7 @@ distributions provide these tools in their packages repositories.
## Building with Maven 3
-[Maven](http://maven.apache.org/) is a build tool that goes far beyond
+[Maven](http://maven.apache.org/ "Maven homepage") is a build tool that goes far beyond
simply compiling and packaging a product. It is also able to resolve
dependencies (including downloading the appropriate versions from the public
repositories), to run automated tests, to launch various checking tools and
@@ -55,14 +57,14 @@ with the following command:
mvn install
For other commands like generating the site, or generating the
-[checkstyle](http://checkstyle.sourceforge.net/),
-[spotbugs](https://spotbugs.github.io/) or
-[jacoco](http://www.eclemma.org/jacoco/) reports, see the maven
-plugins documentation at [maven site](http://maven.apache.org/plugins/index.html).
+[checkstyle](http://checkstyle.sourceforge.net/ "Checkstyle homepage"),
+[spotbugs](https://spotbugs.github.io/ "Spotbugs homepage") or
+[jacoco](http://www.eclemma.org/jacoco/ "Jacoco homepage") reports, see the maven
+plugins documentation at [maven site](http://maven.apache.org/plugins/index.html "Maven plugins homepage").
## Building with Eclipse
-[Eclipse](http://www.eclipse.org/) is a very rich Integrated Development
+[Eclipse](http://www.eclipse.org/ "Eclipse homepage") is a very rich Integrated Development
Environment (IDE). It is a huge product and not a simple build tool.
For systems not providing eclipse as a package, it can be downloaded from its
@@ -90,3 +92,5 @@ The simplest way to use Rugged with Eclipse is to follow these steps:
and Orekit (available at Orekit
[download page](https://www.orekit.org/download.html))
in the libraries tab of the Configure Build Path dialog
+
+[Top of the page](#top)
\ No newline at end of file
diff --git a/src/site/markdown/configuration.md b/src/site/markdown/configuration.md
index 232f475f..e3567f09 100644
--- a/src/site/markdown/configuration.md
+++ b/src/site/markdown/configuration.md
@@ -12,30 +12,32 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Configuration
-As Rugged relied on Orekit for the frames computation, Orekit
+As Rugged relied on [Orekit](https://www.orekit.org/ "Orekit homepage") for the frames computation, Orekit
must be properly initialized for Rugged to run.
-The simplest way to configure is to first retrieve the example orekit-data.zip
-file from Orekit, available in the [Orekit project download page](https://www.orekit.org/download.html) (Physical Data)
-and to unzip it in a known fixed location on your computer (let's assume it is on
-your home folder, and it creates an orekit-data subfolder there).
-
-Then near the start of your main program, and before Orekit is called for the
-first time, you will add the following code snippet:
+The simplest way to configure is to first retrieve the example `orekit-data-master.zip`
+file from Rugged download page, available in the [Rugged project download page](https://www.orekit.org/rugged/download.html)
+(Get the physical data)
+and to unzip it anywhere you want, rename the `orekit-data-master` folder that will be created
+into `orekit-data` and add the following lines at the start of your program (before Orekit is called for the
+first time):
- File home = new File(System.getProperty("user.home"));
- File orekitData = new File(home, "orekit-data");
+ File orekitData = new File("/path/to/the/folder/orekit-data");
DataProvidersManager.getInstance().addProvider(new DirectoryCrawler(orekitData));
This is sufficient to start working.
-Note that some of the data in the orekit-data folder needs to be updated,
+Note that some of the data in the orekit-data-master folder needs to be updated,
typically the UTC-TAI.history file, which is updated about once every 18 months
by IERS, and the files in the Earth-Orientation-Parameters folder which are updated
regularly by IERS. The update frequency depends on which file you use.
-The data provided in the example archive from Orekit site are example only and are
+The data provided in the example archive from Rugged site are example only and are
not kept up to date. The real operational data are live, and remain under the
-responsibility of the user.
\ No newline at end of file
+responsibility of the user.
+
+[Top of the page](#top)
diff --git a/src/site/markdown/contact.md b/src/site/markdown/contact.md
index a1f09010..a321ab0e 100644
--- a/src/site/markdown/contact.md
+++ b/src/site/markdown/contact.md
@@ -12,25 +12,24 @@
limitations under the License.
-->
-# Contacts
-
-## Mailing lists
+<a name="top"></a>
-Most discussions should occur on the public mailing lists.
+# Contacts
-| topic | post address | subscribe URL | archive URL |
-|---------------|------------------------------|--------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
-| announces | orekit-announces@orekit.org | [https://www.orekit.org/wws/subscribe/orekit-announces](https://www.orekit.org/wws/subscribe/orekit-announces) | [https://www.orekit.org/wws/arc/orekit-announces](https://www.orekit.org/wws/arc/orekit-announces) |
-| users | rugged-users@orekit.org | [https://www.orekit.org/wws/subscribe/rugged-users](https://www.orekit.org/wws/subscribe/rugged-users) | [https://www.orekit.org/wws/arc/rugged-users](https://www.orekit.org/wws/arc/rugged-users) |
-| developers | rugged-developers@orekit.org | [https://www.orekit.org/wws/subscribe/rugged-developers](https://www.orekit.org/wws/subscribe/rugged-developers) | [https://www.orekit.org/wws/arc/rugged-developers](https://www.orekit.org/wws/arc/rugged-developers) |
+## Forum
-Please register to these mailing lists before attempting to post!
+Most discussions should occur on the public forums [https://forum.orekit.org/](https://forum.orekit.org/).
+The main categories are:
-We're preventing unregistered members from posting in order to prevent spam. Thank you.
+| category | URL |
+|---------------|----------------------------------------------------------------------------------------------------|
+| announces | [https://forum.orekit.org/c/rugged-announcements](https://forum.orekit.org/c/rugged-announcements) |
+| users | [https://forum.orekit.org/c/rugged-usage](https://forum.orekit.org/c/rugged-usage) |
+| developers | [https://forum.orekit.org/c/rugged-development](https://forum.orekit.org/c/rugged-development) |
## Technical contact
-If for some reason you cannot use the public lists, you can reach the CS
+If for some reason you cannot use the public forums, you can reach the CS
Systèmes d'Information Rugged team for any question (either technically
oriented or administrative) at the following email address:
[rugged@c-s.fr](mailto:rugged@c-s.fr)
@@ -49,3 +48,6 @@ please use the following address:
phone: +33 5-61-17-66-66 (ask for Luc Maisonobe or Sébastien Harasse)
fax: +33 5-61-34-84-15
+
+[Top of the page](#top)
+
\ No newline at end of file
diff --git a/src/site/markdown/contributing.md b/src/site/markdown/contributing.md
index 7983d10c..d19d24f2 100644
--- a/src/site/markdown/contributing.md
+++ b/src/site/markdown/contributing.md
@@ -1,4 +1,4 @@
-<!--- Copyright 2013-2017 CS Systèmes d'Information
+<!--- Copyright 2013-2019 CS Systèmes d'Information
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
@@ -12,8 +12,7 @@
limitations under the License.
-->
-Contributing to Ruggged
-=======================
+# Contributing to Ruggged
Rugged is free software, which means you can use the source code as you wish,
without charges, in your applications, and that you can improve it and have
diff --git a/src/site/markdown/design/design.md b/src/site/markdown/design/design.md
index 36fc4ca4..ecd50541 100644
--- a/src/site/markdown/design/design.md
+++ b/src/site/markdown/design/design.md
@@ -12,6 +12,8 @@
limitations under the License.
-->
+<a name="top"></a>
+
## Design of the major functions
@@ -119,4 +121,6 @@ be reallocated by the Tile. The loader only sees interfaces in the API and doesn
tiles that are used under the hood. Different DEM intersection algorithms can use different tiles implementations without
any change to the mission specific interface. One example of this independence corresponds to the Duvenhage algorithm, has
in addition to the raw elevation grid, the tile will also contain a min/max kd-tree, so there are both a dedicated specialized
-tile and a corresponding TileFactory in use when this algorithm is run.
\ No newline at end of file
+tile and a corresponding TileFactory in use when this algorithm is run.
+
+[Top of the page](#top)
diff --git a/src/site/markdown/design/digital-elevation-model.md b/src/site/markdown/design/digital-elevation-model.md
index b79f0899..e5b0f566 100644
--- a/src/site/markdown/design/digital-elevation-model.md
+++ b/src/site/markdown/design/digital-elevation-model.md
@@ -12,11 +12,13 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Digital Elevation Model
## DEM intersection
-The page [technical choices](./technical-choices.md) explain how Rugged goes from an on-board pixel
+The page [technical choices](./technical-choices.html) explain how Rugged goes from an on-board pixel
line-of-sight to a ground-based line-of-sight arrival in the vicinity of the ellipsoid entry point. At
this step, we have a 3D line defined near the surface and want to compute where it exactly traverses the
Digital Elevation Model surface. There is no support for this computation at Orekit library level,
@@ -55,3 +57,5 @@ On the other hand, Rugged is not expected to parsed DEM files, so the algorithm
layer. In order to pass these data, a specific callback function is implemented in the mission specific interface layer and
registered to Rugged, which can call it to retrieve parts of the DEM, in the form of small cells. The implicit KD-tree is then
built from leafs to root and cached.
+
+[Top of the page](#top)
diff --git a/src/site/markdown/design/overview.md b/src/site/markdown/design/overview.md
index c7f2320c..9e820157 100644
--- a/src/site/markdown/design/overview.md
+++ b/src/site/markdown/design/overview.md
@@ -12,16 +12,18 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Design Overview
## Global architecture
Rugged is an intermediate level mission-independent library. It relies on
-the Orekit library and on the Hipparchus library. It is itself
+the [Orekit](https://www.orekit.org/ "Orekit homepage") library and on the [Hipparchus](https://hipparchus.org/ "Hipparchus homepage") library. It is itself
intended to be used from a mission-specific interface by one or more
image processing applications.
-
+
The Java platform provides the runtime environment, the Hipparchus
library provides the mathematical algorithms (3D geometry, root
@@ -67,7 +69,10 @@ The following table sorts out the various topics between the various layers.
| IERS data correction | Orekit |All frame transforms support the full set of IERS Earth Orientation Parameters corrections, including of course the large DUT1 time correction, but also the smaller corrections to older IAU-76/80 or newer IAU-2000/2006 precession nutation models as well as the polar wander. The frames level accuracy is at sub-millimeter level
| Grid-post elevation model | Rugged |Only raster elevation models are supported
|Triangulated Irregular Network elevation model | Not supported |If vector elevation models are needed, they must be converted to raster form in order to be used
-| Geoid computation | Orekit |Rugged expects the Digital Elevation Models to be provided with respect to a reference ellipsoid. Orekit can be used to convert a geoid-based DEM to an ellipsoid-based DEM, directly from any gravity field
+| Geoid computation | Orekit |Rugged expects the Digital Elevation Models to be provided with respect to a reference ellipsoid. Orekit can be used to convert a geoid-based DEM to an ellipsoid-based DEM, directly from any gravity field
| Time-dependent deformations | Interface/Rugged |Simple line-of-sight models (typically polynomial) can be used
| Calibration |Image processing or interface|The calibration phase remains at the mission-specific caller level (pixels geometry, clock synchronization …), the caller is required to provide the already calibrated line of sights
| DEM file parsing | Interface |The elevation models are dedicated to the mission and there are several formats (DTED, GeoTIFF, raw data …).Rugged only deals with raw elevation on small latitude/longitude cells
+| Atmospheric refraction | Abstract/Rugged |Atmospheric refraction correction is supported with a default multi-layer model provided. Some other models can be provided by the user
+
+[Top of the page](#top)
diff --git a/src/site/markdown/design/technical-choices.md b/src/site/markdown/design/technical-choices.md
index d54090af..f1fa8626 100644
--- a/src/site/markdown/design/technical-choices.md
+++ b/src/site/markdown/design/technical-choices.md
@@ -11,11 +11,14 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
+
+<a name="top"></a>
+
# Technical choices
## Earth frames
-As Rugged is built on top of Orekit and Hipparchus, all the flight dynamics and
+As Rugged is built on top of [Orekit](https://www.orekit.org/ "Orekit homepage") and [Hipparchus](https://hipparchus.org/ "Hipparchus homepage"), all the flight dynamics and
mathematical computation are delegated to these two libraries and the full accuracy available
is used. This implies for example that when computing frames conversions between the inertial
frame and the Earth frame, the complete set of IERS Earth Orientation Parameters (EOP)
@@ -33,7 +36,7 @@ regular signal with several harmonics, which correspond to the nutation componen
not in this older model. This error was small in the 80's but is much higher now (as of 2014,
it is of the order of magnitude of 3 meters). The error is steadily increasing.
-
+
Note that this error occurs when the initial data for spacecraft position is initially given in
inertial frame and must be converted to Earth frame. This typically occurs in mission analysis
@@ -59,7 +62,7 @@ better than the former ones. The much better accuracy of these new models can be
kind of plot as before, i.e. ignoring temporarily the IERS corrections. The following figure shows the
result.
-
+
The remaining error is very small, of the order of magnitude of 2 or 3 centimeters. Rugged is not
limited to the legacy MOD and TOD frames and can use the newer IERS recommended frames as well. From
@@ -158,7 +161,7 @@ time than the position of the spacecraft. The expected difference can be predict
light travel time, it is about 1.2m at equator, in the East-West direction. This effect is compensated by applying the so-called
light-time correction.
-
+
The delay is computed for each pixel as the travel time is shorter for pixels looking in the nadir direction than for pixels
looking at the edge of field of view. As Orekit frame transforms automatically include a local Taylor expansion of the transform,
@@ -175,7 +178,7 @@ This effect is a large one and can correspond to up to a 20m shift once projecte
As shown in next figure, from spacecraft point of view, the light incoming from the ground point seems to come from a fictitious
point “ahead†of the real point.
-
+
As a side note, aberration of light and light time correction can be linked or considered to be two aspects of a similar phenomenon,
even in classical (non-relativistic) physics. It depends on the frame in which we look at the various elements. If the source is
@@ -208,7 +211,7 @@ computing only two points10 introduces yet another error, which is transverse to
at middle point. This assumption is a flat-body assumption, i.e. it correspond to locally approximating the ellipsoid to its tangential
plane. The error is the sagitta due to the bending of the real line-of-sight in the geodetic space.
-
+
This error depends on the diving angle of the line-of-sight with respect to local vertical. It is zero for a diving angle of 90 degrees
(i.e. a pure nadir line-of-sight) and increases as the diving angle decreases. It can reach tremendous values (hundreds of meters or
@@ -235,3 +238,5 @@ The following table summarizes the error compensations performed in the Rugged l
| aberration of light | 20m | along track |depends on spacecraft velocity, can be switched off if compensated elsewhere in the processing chain
| flat-body | 0.8m | across line-of-sight |error increases a lot for large fields of view, can be switched off, but this is not recommended
| atmospheric refraction | < 2m | horizontal shift |for multi-layer atmospheric model
+
+[Top of the page](#top)
diff --git a/src/site/markdown/downloads.md b/src/site/markdown/downloads.md
index ed611bd0..a72452d7 100644
--- a/src/site/markdown/downloads.md
+++ b/src/site/markdown/downloads.md
@@ -1,10 +1,10 @@
-<!--- Copyright 2013-2018 CS Systèmes d'Information
+<!--- Copyright 2013-2019 CS Systèmes d'Information
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
-
+
http://www.apache.org/licenses/LICENSE-2.0
-
+
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -12,12 +12,14 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Downloads
## Development Library version
The development version of the Rugged library is always available to
-download from our version control system. We use [ Git](http://git-scm.com/)
+download from our version control system. We use [Git](http://git-scm.com/ "Git homepage")
as our SCM. The anonymous read access to our Git repository allows users who
need the latest features and the latest bug fixes to get them even before an
official release.
@@ -27,9 +29,7 @@ be easily adapted if you are using one of the numerous Git graphical
user interface available or if Git is supported by you integrated
development environment:
- git clone https://gitlab.orekit.org/orekit/rugged.git
-
- :interrobang: EXPLANATIONS TO ADD about branches : master, develop, ... :interrobang:
+ git clone -b develop https://gitlab.orekit.org/orekit/rugged.git
## Released Library versions
@@ -61,36 +61,39 @@ version 1.0 downloads (release date: 2016-02-10)
## Data
-For convenience, a zip archive containing some configuration data is
-available for download. Similar files can be custom made by users with updated data.
-Configuring data loading is explained in the configuration page For a start, the simplest configuration
-is to download the orekit-data.zip file from the download page, to unzip it anywhere you want, note the
-path of the orekit-data folder that will be created and add the following lines at the start of
-your program:
+For convenience, a zip archive containing some configuration data is available
+for download. Similar files can be custom made by users with updated data.
+Configuring data loading is explained in the configuration page. For a start,
+the simplest configuration is to download the
+[orekit-data-master.zip](https://gitlab.orekit.org/orekit/orekit-data/-/archive/master/orekit-data-master.zip)
+file from the forge, to unzip it anywhere you want, rename the `orekit-data-master` folder that will be created
+into `orekit-data` and add the following lines at the start of your program:
File orekitData = new File("/path/to/the/folder/orekit-data");
DataProvidersManager manager = DataProvidersManager.getInstance();
manager.addProvider(new DirectoryCrawler(orekitData));
-This file contents is:
+This file contains the following data sets. Note that the data is updated only
+from time to time, so users must check by themselves they cover the time range
+needed for their computation.
- * leap seconds data up to end of 2017,
+ * leap seconds data,
- * IERS Earth orientation parameters from 1973 to end 2017
- with predicted date to mid 2018 for some parameters (both IAU-1980 and IAU-2000),
+ * IERS Earth orientation parameters from 1973 (both IAU-1980 and IAU-2000),
- * Marshall Solar Activity Futur Estimation from 1999 to end 2017,
+ * Marshall Solar Activity Future Estimation from 1999,
* DE 430 planetary ephemerides from 1990 to 2069,
- * Eigen 06S gravity field,
+ * Eigen 06S gravity field.
- * FES 2004 ocean tides model.
There are no guarantees that this file will be available indefinitely or that its
content will be updated. It should be considered as a simple configuration example.
Users are encouraged to set up their own configuration data.
+The file is available by following the
+[download](https://gitlab.orekit.org/orekit/orekit-data/-/archive/master/orekit-data-master.zip)
+link in the project dedicated to Orekit Data in the forge.
-The orekit-data.zip file is available in the [Orekit project download page](https://www.orekit.org/download.html) (Physical Data).
-
+[Top of the page](#top)
diff --git a/src/site/markdown/faq.md b/src/site/markdown/faq.md
index 4f744f82..353c270e 100644
--- a/src/site/markdown/faq.md
+++ b/src/site/markdown/faq.md
@@ -1,4 +1,4 @@
-<!--- Copyright 2013-2018 CS Systèmes d'Information
+<!--- Copyright 2013-2019 CS Systèmes d'Information
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
@@ -11,15 +11,26 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-# FAQ
+
+<a name="top"></a>
+
+# Frequently Asked Questions (FAQ)
## References
### Has Rugged already been used?
-Yes. Rugged is used operationally in the Image Processing Facility
+Yes, it has been used in successful operational missions.
+
+Rugged is used operationally in the Image Processing Facility
of the Sentinel 2 ESA mission, which was launched in June 2015.
+Rugged is used in the frame of ESA Scientific Exploitation of Operational Missions (SEOM),
+to calculate topographic shadow masks for Sentinel 2 products.
+
+Rugged has been used as a Research Library by the French Space Agency (CNES) for
+study on refining for VHR push broom sensors (Pleiades).
+
### Is Rugged validated?
Yes, Rugged has been validated, by comparison with other image
@@ -43,8 +54,8 @@ TOD and MOD frames are available for consistency with existing systems).
### What are the dependencies for Rugged?
-Rugged relies on the Orekit space flight dynamics library and on
-Hipparchus mathematical libraries. Both libraries are free
+Rugged relies on the [Orekit](https://www.orekit.org/ "Orekit homepage") space flight dynamics library and on
+[Hipparchus](https://hipparchus.org/ "Hipparchus homepage") mathematical libraries. Both libraries are free
software libraries distributed under the terms of the Apache Software
License version 2.0.
@@ -52,26 +63,30 @@ License version 2.0.
### I get an error "no IERS UTC-TAI history data loaded" (or something similar in another language). What does it mean?
-This error is probably the most frequent one, or at least it's the first one new users encounter.
+This error is probably *the* most frequent one, or at least it's the first one new users encounter.
Rugged relies on the Orekit library to perform all space flight related computation (typically
frames transforms). This library in turn needs some external data to be loaded in order to run.
This includes UTC-TAI history for leap seconds handling, Earth Orientation Parameters for
-transforms to and from Earth fixed frames, or planetar ephemerides for Sun direction, for example.
+transforms to and from Earth fixed frames, or planetary ephemerides for Sun direction, for example.
The error message "no IERS UTC-TAI history data loaded" means the UTC-TAI history file which is used for leap
seconds management was not found. As leap seconds are used each time a UTC date is used, this message is
often seen very early and is the first one unsuspecting users experience. It often means the user forgot
-to configure Orekit to load data.
+to configure Orekit to load data. Orekit supports by default either the IERS UTC-TAI.history file or the
+USNO tai-utc.dat file. If either file is found in the Orekit configuration, it will be automatically loaded
+and the message should not appear.
-Configuring data loading is explained in the configuration page For a start, the simplest configuration
-is to download the orekit-data.zip file available in the [Orekit project download page](https://www.orekit.org/download.html) (Physical Data)., to unzip it anywhere you
-want, note the path of the orekit-data folder that will be created and add the following lines at the start
-of your program:
+Configuring data loading is explained in the configuration page. For a start, the simplest configuration
+ is to download the [orekit-data-master.zip](https://gitlab.orekit.org/orekit/orekit-data/-/archive/master/orekit-data-master.zip)
+file from the forge, to unzip it anywhere you want, rename the `orekit-data-master` folder that will be created
+into `orekit-data` and add the following lines at the start of your program:
File orekitData = new File("/path/to/the/folder/orekit-data");
DataProvidersManager manager = DataProvidersManager.getInstance();
manager.addProvider(new DirectoryCrawler(orekitData));
Using a folder allows one to change the data in it after the initial download, e.g., adding new EOP files as they
-are published by IERS.
+are published by IERS. Updating the content of the orekit-data remains the responsibility of the user.
+
+[Top of the page](#top)
diff --git a/src/site/markdown/guidelines.md b/src/site/markdown/guidelines.md
index f5e87394..678b2181 100644
--- a/src/site/markdown/guidelines.md
+++ b/src/site/markdown/guidelines.md
@@ -2,15 +2,18 @@
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
-
+
http://www.apache.org/licenses/LICENSE-2.0
-
+
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
+
+<a name="top"></a>
+
# Development Guidelines
The following guidelines are used for Rugged development.
@@ -31,7 +34,7 @@ operations. The main driving goals are the following ones:
The first goal, validation, implies tests must be as extensive as possible.
They should include realistic operational cases but also contingency cases.
-The [jacoco](http://www.eclemma.org/jacoco/) tool must be used to
+The [jacoco](http://www.eclemma.org/jacoco/ "Jacoco homepage") tool must be used to
monitor test coverage. A very high level of coverage is desired. We do not
set up mandatory objective figures, but only guidelines here. However,a 60%
line coverage would clearly not be acceptable at all and 80% would be considered
@@ -41,7 +44,7 @@ The second goal, robustness, has some specific implications for a low level
component like Rugged. In some sense, it can be considered an extension of the
previous goal as it can also be improved by testing. It can also be improved
by automatic checking tools that analyze either source code or binary code. The
-[spotbugs](https://spotbugs.github.io/) tool is already configured for
+[spotbugs](https://spotbugs.github.io/ "Spotbugs homepage") tool is already configured for
automatic checks of the library using a maven plugin.
This is however not sufficient. A library is intended to be used by applications
@@ -83,15 +86,15 @@ Orbits, dates, vectors, and rotations are all immutable objects.
## Source Control Management
-The source code control management system used is [Git](http://git-scm.com/). The
-main Rugged repository is located at [https://gitlab.orekit.org/orekit/rugged](https://gitlab.orekit.org/orekit/rugged).
+The source code control management system used is [Git](http://git-scm.com/ "Git homepage"). The
+main Rugged repository is located at [https://gitlab.orekit.org/orekit/rugged.git](https://gitlab.orekit.org/orekit/rugged.git).
Starting after version 2.0, the branch management workflow is adapted from
both [git flow](http://nvie.com/posts/a-successful-git-branching-model/) and
-from the [Orfeo ToolBox Workflow](https://wiki.orfeo-toolbox.org/index.php/Git#Workflow).
-It is the same as chosen for [Orekit branch management workflow](https://gitlab.orekit.org/orekit/orekit/blob/master/src/site/markdown/guidelines.md).
+from the [Orfeo ToolBox Workflow](https://wiki.orfeo-toolbox.org/index.php/Git#Workflow "OTB workflow").
+It is the same as chosen for Orekit.
-
+
This implies that development occurs on a develop branch only.
Developers create feature branches, and merge them on the develop
@@ -134,8 +137,7 @@ release branches or bugfix branches branches to it.
For reading ease and consistency, the existing code style should be
preserved for all new developments. The rules are common ones, inherited
-mainly from the Sun :interrobang:[Code Conventions for the Java
-Programming Language](http://java.sun.com/docs/codeconv/) :interrobang: guide style and
+mainly from the Sun Code Conventions for the Java Programming Language guide style and
from the default [checkstyle](http://checkstyle.sourceforge.net/) tool
configuration. A few of these rules are displayed below. The complete
definition is given by the checkstyle configuration file in the project
@@ -144,55 +146,55 @@ root directory.
* *header rule*
all source files start with the Apache license header,
-
+
* *indentation rules*
no tabs, 4 spaces indentation, no indentation for case statements,
-
+
* *operators wrapping rules*
lines are wrapped after operators (unlike Sun),
-
+
* *whitespace rules*
operators are surrounded by spaces, method parameters open parenthesis
is not preceded by space, lines do not end with white space,
-
+
* *curly brace rules*
open curly brace are at end of line, with the matching closing curly brace
aligned with the start of the corresponding keyword (_if_, _for_,
_while_, _case_ or _do_),
-
+
* *encoding rules*
characters encoding is _UTF8_, the git property _core.autocrlf_ should be
set to _input_ on Linux development machines and to _true_ on Windows
development machines (to ensure proper conversion on all operating systems),
-
+
* *naming rules*
classes names begin with upper case, instance methods and fields
names begin with lower case, class fields are all upper case with
words separated by underscores,
-
+
* *ordering rules*
class variables come first, followed by instance variables, followed
by constructors, and followed by methods, public modifiers come first,
followed by protected modifiers followed by private modifiers,
-
+
* *javadoc rules*
all elements have complete javadoc, even private fields and methods
(there are some rare exceptions, in case of code translated from
the fortran language and models with huge parameters sets),
-
+
* *robustness rules*
switch/case construct have a default argument, even when all possible
cases are already handled, as many classes as possible are immutable,
-
+
* *miscellaneous rules*
_star_ imports are forbidden, parameters and local variables are final
@@ -230,3 +232,6 @@ root directory.
* *checkstyle* (style)
fix _all_ errors and warnings found by checkstyle
+
+[Top of the page](#top)
+
\ No newline at end of file
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index bf445fc1..32ac5cff 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -12,13 +12,15 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Overview
- Rugged is a sensor-to-terrain mapping tool which takes into account Digital Elevation Models (DEM)
+ Rugged is a sensor-to-terrain mapping tool which takes into account Digital Elevation Models (DEM)
in its line of sight computation. It is a free software
- intermediate-level library written in Java and implemented as an add-on for Orekit.
+ intermediate-level library written in Java and implemented as an add-on for [Orekit](https://www.orekit.org/ "Orekit homepage").
- 
+ 
It mainly provides direct and inverse location, i.e. it allows
to compute accurately which ground point is looked at from a specific
@@ -29,7 +31,7 @@
on-board sensor pixels individual line-of-sights, spacecraft motion and
attitude and several physical effects.
-
+
*Effects of taking into account the DEM in the computation of latitude, longitude and altitude*
Direct and inverse location can be used to perform full ortho-rectification
@@ -41,13 +43,13 @@
* Refinement
- * can support several types of Digital Elevation Models, including user-provided models
+ * Can support several types of Digital Elevation Models, including user-provided models
- * several intersection models algorithms available
+ * Several intersection models algorithms available
- * can propagate orbit by itself for preliminary mission analysis or data generation
+ * Can propagate orbit by itself for preliminary mission analysis or data generation
- * can propagate attitude by itself for preliminary mission analysis or data generation
+ * Can propagate attitude by itself for preliminary mission analysis or data generation
* *very* fast
@@ -56,7 +58,7 @@
* Mathews, Herring, Buffett (2002)
* Capitaine (2006)
- * complete set of corrections applied for greater accuracy
+ * Complete set of corrections applied for greater accuracy
* δΔψ, δΔε on precession nutation (about 3m correction since 2013, steadily increasing)
* ΔUTâ‚, lod on proper rotation (can theoretically reach up to 400m)
* u, v pole wander (polhody), (about 15m correction)
@@ -66,9 +68,9 @@
(0m at nadir, 10m at 30° dive angle, hundreds of meters for skimming los)
* atmospheric refraction
- * not limited to Earth
+ * Not limited to Earth
- * highly portable (Linux, Windows, MacOSX, ...)
+ * Highly portable (Linux, Windows, MacOSX, ...)
* Localized in several languages
@@ -87,7 +89,7 @@
Rugged is freely available both in source and binary formats, with all related
documentation and tests.
-It is distributed under the [Apache License Version 2.0](LICENSE.txt). This
+It is distributed under the [Apache License Version 2.0](./license.html). This
is a well known business-friendly license. This means anybody can use it to build
any application, free or not. There are no strings attached to your own code.
@@ -96,9 +98,15 @@ interoperability in space systems.
## Maintained library
-Rugged has been in development since 2014 inside [CS Systèmes
-d'Information](http://www.c-s.fr/) and is still used and maintained by its dual teams
+Rugged has been in development since 2014 inside [CS Systèmes d'Information](http://www.c-s.fr/ "CS SI homepage")
+and is still used and maintained by its dual teams
of space dynamics and image processing experts.
Rugged is used for image processing of the Sentinel 2 mission at European Space
-Agency (ESA).
+Agency (ESA), as well as in the frame of ESA Scientific Exploitation of Operational Missions (SEOM),
+to calculate topographic shadow masks for Sentinel 2 products.
+
+Rugged has been also used as a Research Library by the French Space Agency (CNES) for
+study on refining for VHR push broom sensors (Pleiades).
+
+[Top of the page](#top)
\ No newline at end of file
diff --git a/src/site/markdown/sources.md b/src/site/markdown/sources.md
index 622d66c0..fcc10ebc 100644
--- a/src/site/markdown/sources.md
+++ b/src/site/markdown/sources.md
@@ -2,9 +2,9 @@
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
-
+
http://www.apache.org/licenses/LICENSE-2.0
-
+
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -12,30 +12,44 @@
limitations under the License.
-->
-# Getting the sources
+<a name="top"></a>
+# Getting the sources
## Released versions
In order to get the source for officially released versions, go to the
-[Downloads page](src/site/markdown/downloads.md) and select one of the
-rugged-x.y-sources.zip files.
-The x.y part in the name specifies the version.
+[Release page](https://gitlab.orekit.org/orekit/rugged/tags) in Rugged
+forge and select one of the `rugged-x.y-sources.zip` files. The `x.y` part in the name
+specifies the version.
+
+If this is the first time you download the library and
+you have not yet set up your own data set with UTC-TAI history, JPL ephemerides,
+IERS Earth Orientation Parameters ... you may want to also download the
+`orekit-data.zip` file which is an example file suitable for a quick start (see
+[configuration](./configuration.html) for further reading about data configuration).
+
+It is also possible to retrieve published versions from the Git repository
+(see next section below), if retrieving either release-x.y branches or the
+master branch.
## Development version
-The development of the Rugged project is done using the [Git](http://git-scm.com/)
-source code control system. Rugged Git master repository is available online.
+The development of the Rugged project is done using the [Git](http://git-scm.com/ "Git homepage")
+source code control system. Rugged Git master repository is available online.
+The latest developments are in the develop branch. This is the one you want to retrieve
+if you need the latest feature before they are published in an official release.
+See [guidelines](./guidelines.html) for the branching workflow used in Rugged.
-You can browse it using the [Repository](https://gitlab.orekit.org/orekit/rugged)
+ * you can browse it using the [Repository](https://gitlab.orekit.org/orekit/rugged/tree/develop)
tab in Rugged Gitlab.
-`You can clone it anonymously with the command:`
+ * you can clone it anonymously with the command:
+
+ git clone -b develop https://gitlab.orekit.org/orekit/rugged.git
- git clone https://gitlab.orekit.org/orekit/rugged.git
+ * if you are a committer, you can clone it using your ssh credentials with the command:
-`If you are a committer, you can clone it using your ssh credentials with the command:`
+ git clone -b develop git@gitlab.orekit.org:orekit/rugged.git
- git clone git@gitlab.orekit.org:orekit/rugged.git
-
-:interrobang:`In both cases, the development version is under the branch develop TO BE COMPLETED`.:interrobang:
+[Top of the page](#top)
\ No newline at end of file
diff --git a/src/site/markdown/tutorials/direct-location-with-DEM.md b/src/site/markdown/tutorials/direct-location-with-DEM.md
index 04aceaae..63f8e26a 100644
--- a/src/site/markdown/tutorials/direct-location-with-DEM.md
+++ b/src/site/markdown/tutorials/direct-location-with-DEM.md
@@ -12,6 +12,8 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Direct Location with a DEM
The aim of this tutorial is to compute a direct location grid by intersection of
@@ -20,7 +22,7 @@ This algorithm is the most performant one in Rugged.
The following figure shows the effects of taking into account the DEM in the computation of latitude, longitude and altitude:
-
+
## Feeding Rugged with DEM tiles
@@ -44,18 +46,18 @@ In this tutorial, we will not include real DEM data. Instead we are going to cre
representing a volcano in a form of a perfect cone, similar to the Mayon volcano
in the Philippines, except that we will locate it somewhere just below our satellite.
This example is already part of Rugged tests cases, the source code is available
-in the package *org.orekit.rugged.raster*, file VolcanicConeElevationUpdater.java.
+in the package `org.orekit.rugged.raster`, file VolcanicConeElevationUpdater.java.
-The class *VolcanicConeElevationUpdater* implements the interface *TileUpdater* with its method *updateTile*.
+The class `VolcanicConeElevationUpdater` implements the interface `TileUpdater` with its method `updateTile`.
The method is in charge of loading a tile. The extent of the tile must be such that it covers
at least the ground point with coordinates (latitude, longitude) which are passed as arguments to the method.
-The tile is an object of type *UpdatableTile* which has two methods :
+The tile is an object of type `UpdatableTile` which has two methods :
-* *setGeometry(minLatitude, minLongitude, latitudeStep, longitudeStep, latitudeRows, longitudeRows)* : initializes the extent of the new tile before loading
+* `setGeometry(minLatitude, minLongitude, latitudeStep, longitudeStep, latitudeRows, longitudeRows)` : initializes the extent of the new tile before loading
-* *setElevation(latIdx, longIdx, elevation)* : fills the tile buffer at indices (latIdx, lonIdx) with value elevation
+* `setElevation(latIdx, longIdx, elevation)` : fills the tile buffer at indices (latIdx, lonIdx) with value elevation
-Here's the source code of the class *VolcanicConeElevationUpdater* :
+Here's the source code of the class `VolcanicConeElevationUpdater` :
import org.hipparchus.util.FastMath;
import org.orekit.rugged.raster.TileUpdater;
@@ -106,21 +108,21 @@ Here's the source code of the class *VolcanicConeElevationUpdater* :
### Important notes on DEM tiles :
-* Ground point elevation are obtained by bilinear interpolation between 4 neighbouring cells. There is no specific algorithm for border management. As a consequence, a point falling on the border of the tile is considered outside. **DEM tiles must be overlapping by at least one line/column in all directions**, :interrobang: in a similar way as for the SRTM DEMs. :interrobang:
+* Ground point elevation are obtained by bilinear interpolation between 4 neighbouring cells. There is no specific algorithm for border management. As a consequence, a point falling on the border of the tile is considered outside. **DEM tiles must be overlapping by at least one line/column in all directions**.
* In Rugged terminology, the minimum latitude and longitude correspond to the centre of the farthest Southwest cell of the DEM. Be careful if using GDAL to pass the correct information as there is half a pixel shift with respect to the lower left corner coordinates in gdalinfo.
The following diagram illustrates proper DEM tiling with one line/column overlaps between neighbouring tiles :
-
+
This diagram tries to represent the meaning of the different parameters in the definition of a tile :
-
+
## Initializing Rugged with a DEM
-The initialization step differs slightly from the first tutorial [Direct location](direct-location.md),
+The initialization step differs slightly from the first tutorial [Direct location](./direct-location.html),
as we need to pass the information about our TileUpdater.
Instantiate an object derived from TileUpdater :
@@ -146,7 +148,7 @@ Initialize Rugged with these parameters :
## Computing a direct location grid
-In a similar way as in the first tutorial [Direct Location](direct-location.md),
+In a similar way as in the first tutorial [Direct Location](./direct-location.html),
we call Rugged direct location method. This time it is called in a loop so as to generate a full grid on disk.
DataOutputStream dos = new DataOutputStream(new FileOutputStream("demDirectLoc.c1"));
@@ -189,4 +191,6 @@ we call Rugged direct location method. This time it is called in a loop so as to
}
## Source code
-The source code is available in [DirectLocationWithDEM.java](src/tutorials/java/fr/cs/examples/DirectLocationWithDEM.java) (package fr.cs.examples under src/tutorials)
+The source code is available in DirectLocationWithDEM.java (package fr.cs.examples under src/tutorials)
+
+[Top of the page](#top)
diff --git a/src/site/markdown/tutorials/direct-location.md b/src/site/markdown/tutorials/direct-location.md
index d350cf39..9b87aa83 100644
--- a/src/site/markdown/tutorials/direct-location.md
+++ b/src/site/markdown/tutorials/direct-location.md
@@ -12,6 +12,8 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Rugged initialization and direct location
This tutorial explains how to initialize Rugged and use it to geolocate a satellite image.
@@ -21,7 +23,7 @@ list of positions, velocities and attitude quaternions recorded during the acqui
passing all this information to Rugged, we will be able to precisely locate each point of
the image on the Earth. Well, not exactly precise, as this first tutorial does not use a
Digital Elevation Model, but considers the Earth as an ellipsoid. The DEM will be added in
-a second tutorial: [Direct location with a DEM](direct-location-with-DEM.md). The objective
+a second tutorial: [Direct location with a DEM](./direct-location-with-DEM.html). The objective
here is limited to explain how to initialize everything Rugged needs to know about the sensor
and the acquisition.
@@ -127,9 +129,9 @@ which frames we are using and convert if necessary.
Conversion from inertial to Earth-rotating frame is transparent to the user and is based on the most
recent precession/nutation model on top of which corrections published by the IERS are applied. IERS
-bulletins and other physical data are provided within the orekit-data folder. There are several ways
+bulletins and other physical data are provided within the orekit data folder. There are several ways
to configure Orekit to use this data. More information is given
-[here](https://gitlab.orekit.org/orekit/orekit/tree/master/src/site/markdown/configuration.md).
+[here](../configuration.html)
In our application, we simply need to know the name of the frames we are working with. Positions and
velocities are given in the ITRF terrestrial frame, while the quaternions are given in EME2000
@@ -164,7 +166,7 @@ where, for instance, gpsDateAsString is set to "2009-12-11T10:49:55.899994"
### Positions and velocities
-Similarly the positions and velocities will be set in a list of *TimeStampedPVCoordinates*. Before being
+Similarly the positions and velocities will be set in a list of `TimeStampedPVCoordinates`. Before being
added to the list, they must be transformed to EME2000:
import org.orekit.utils.TimeStampedPVCoordinates;
@@ -217,17 +219,17 @@ returns the builder instance, and therefore another setter can be called directl
The *setAlgorithm* setter specifies the intersection algorithm to use. As this tutorial is intended to be very
simple for a beginning, we choose to use directly the ellipsoid and not a real Digital Elevation Model,
-so we can use *AlgorithmId.IGNORE_DEM_USE_ELLIPSOID* as the single parameter of this setter.
+so we can use `AlgorithmId.IGNORE_DEM_USE_ELLIPSOID` as the single parameter of this setter.
The *setDigitalElevationModel* setter specifies the Digital Elevation Model. In fact, as we decided to ignore the Digital
Elevation Model in this tutorial, we could have omitted this call and it would have worked correctly.
We preferred to let it in so users do not forget to set the Digital Elevation Model for intersection
algorithms that really use them. As the model will be ignored, we can put the parameters for this
-setter to *null* and *0*. Of course if another algorithm had been chosen, null parameters would clearly
-not work, this is explained in another tutorial: [Direct location with a DEM](direct-location-with-DEM.md).
+setter to `null` and `0`. Of course if another algorithm had been chosen, null parameters would clearly
+not work, this is explained in another tutorial: [Direct location with a DEM](./direct-location-with-DEM.html).
The *setEllipsoid* setter defines the shape and orientation of the ellipsoid. We use simple predefined enumerates:
-*EllipsoidId.WGS84*, *InertialFrameId.EME2000*, but could also use a custom ellipsoid if needed.
+`EllipsoidId.WGS84`, `InertialFrameId.EME2000`, but could also use a custom ellipsoid if needed.
The *setTimeSpan* setter is used to define the global time span of the search algorithms (direct and inverse
location). Four parameters are used for this: acquisitionStartDate, acquisitionStopDate,
@@ -249,18 +251,18 @@ timeTolerance = 5 / lineSensor.getRate(0)).
The *setTrajectory* setter defines the spacecraft evolution. The arguments are the list of time-stamped positions and
velocities as well as the inertial frame with respect to which they are defined and options for interpolation:
number of points to use and type of filter for derivatives. The interpolation polynomials for nbPVPoints
-without any derivatives (case of *CartesianDerivativesFilter.USE_P*: only positions are used, without velocities)
+without any derivatives (case of `CartesianDerivativesFilter.USE_P`: only positions are used, without velocities)
have a degree nbPVPoints - 1. In case of computation with velocities included (case of
-*CartesianDerivativesFilter.USE_PV*), the interpolation polynomials have a degree 2*nbPVPoints - 1. If the
+`CartesianDerivativesFilter.USE_PV`), the interpolation polynomials have a degree 2*nbPVPoints - 1. If the
positions/velocities data are of good quality and separated by a few seconds, one may choose only a few points
but interpolate with both positions and velocities; in other cases, one may choose more points but interpolate
only with positions. We find similar arguments for the attitude quaternions.
-The last setter used, *addLineSensor*, registers a line sensor. As can be deduced from its prefix (*add* instead of *set*), it
+The last setter used, *addLineSensor*, registers a line sensor. As can be deduced from its prefix (`add` instead of `set`), it
can be called several time to register several sensors that will all be available in the built Rugged instance.
We have called the method only once here, so we will use only one sensor.
-After the last setter has been called, we call the *build()* method which really build the Rugged instance
+After the last setter has been called, we call the `build()` method which really build the Rugged instance
(and not a RuggedBuilder instance has the setter did).
Rugged takes into account by default some corrections for more accurate locations:
@@ -272,7 +274,7 @@ Not compensating the delay or the velocity composition are mainly useful for val
that do not compensate it. When the pixels line of sight already includes the aberration of light correction,
one must obviously deactivate the correction.
-If those corrections should be ignored, some other setters must be inserted before the call to *build()*:
+If those corrections should be ignored, some other setters must be inserted before the call to `build()`:
setXxxx().
setLightTimeCorrection(false).
@@ -280,9 +282,9 @@ If those corrections should be ignored, some other setters must be inserted befo
build();
The various setters can be called in any order. The only important thing is that once a Rugged instance
-has been created by calling the *build()* method, it is independent from the builder so later calls
+has been created by calling the `build()` method, it is independent from the builder so later calls
to setters will not change the build instance. In fact, it is possible to create a builder, then
-call its *build()* method to create a first Rugged instance, and then to modify the builder configuration
+call its `build()` method to create a first Rugged instance, and then to modify the builder configuration
by calling again some of the setters and building a second Rugged instance from the new configuration.
This allows to perform comparisons between two different configurations in the same program and without
having to recreate everything. For instance, one can procede in three steps like this:
@@ -320,4 +322,6 @@ Otherwise an ArrayIndexOutOfBoundsException will be thrown.
## Source code
-The source code is available in [DirectLocation.java](src/tutorials/java/fr/cs/examples/DirectLocation.java) (package fr.cs.examples under src/tutorials)
+The source code is available in DirectLocation.java (package fr.cs.examples under src/tutorials)
+
+[Top of the page](#top)
diff --git a/src/site/markdown/tutorials/inverse-location.md b/src/site/markdown/tutorials/inverse-location.md
index de6deca8..f4fa8dac 100644
--- a/src/site/markdown/tutorials/inverse-location.md
+++ b/src/site/markdown/tutorials/inverse-location.md
@@ -12,6 +12,8 @@
limitations under the License.
-->
+<a name="top"></a>
+
# Inverse Location
The aim of this tutorial is to compute the inverse location of a point on Earth
@@ -21,7 +23,7 @@ We will also explain how to find the date at which sensor sees a ground point,
which is a kind of inverse location only focusing on date.
## Inverse location of a point on Earth
-The initialization of Rugged is similar as in the [Direct location](direct-location.md) tutorial up to rugged initialization..
+The initialization of Rugged is similar as in the [Direct location](./direct-location.html) tutorial up to rugged initialization..
### Point defined by its latitude, longitude and altitude
Once Rugged initialized, one can compute the line number and the pixel number of a point defined by its Geodetic coordinates:
@@ -82,4 +84,6 @@ then one can compute the inverse location:
SensorPixel sensorPixel = rugged.inverseLocation(sensorName, gp, minLineRough, maxLineRough);
## Source code
-The source code is available in [InverseLocation.java](src/tutorials/java/fr/cs/examples/InverseLocation.java) (package fr.cs.examples under src/tutorials)
+The source code is available in InverseLocation.java (package fr.cs.examples under src/tutorials)
+
+[Top of the page](#top)
diff --git a/src/site/markdown/tutorials/matlab-example.md b/src/site/markdown/tutorials/matlab-example.md
index 61717090..faec9b8e 100644
--- a/src/site/markdown/tutorials/matlab-example.md
+++ b/src/site/markdown/tutorials/matlab-example.md
@@ -1,11 +1,25 @@
+<!--- Copyright 2013-2018 CS Systèmes d'Information
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
# Calling Rugged from Matlab
Examples of direct and inverse location were provided by the Centre de Techniques Spatiales of the Algerian Space Agency.
-If you have any question about the examples, please contact issam.boukerch@yahoo.fr, researcher at the CTS.
-
-* [Direct location](src/site/resources/sources/matlab-examples/DirectLocation.m)
-* [Inverse location](src/site/resources/sources/matlab-examples/InverseLocation.m)
-* [Function to parse a DIMAP file](src/site/resources/sources/matlab-examples/dim2rugged.m)
+Under `src/site/resources/sources/matlab-examples/` :
+
+ * Direct location: `DirectLocation.m`
+ * Inverse location: `InverseLocation.m`
+ * Function to parse a DIMAP file: `dim2rugged.m`
-Thank you Issam for your contribution!
\ No newline at end of file
+If you have any question about the examples, please contact issam.boukerch@yahoo.fr, researcher at the CTS.
diff --git a/src/site/resources/images/rugged-architecture.odg b/src/site/resources/images/rugged-architecture.odg
new file mode 100644
index 0000000000000000000000000000000000000000..e1449e7299ab529ff5854e316977a4ad006bb011
GIT binary patch
literal 14503
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
BoQVJc
literal 0
HcmV?d00001
diff --git a/src/site/resources/images/rugged-architecture.png b/src/site/resources/images/rugged-architecture.png
index f947765ed55c9eeb71f1941d8edb27848c1651f3..d0304d24a51fe6806cba404af5f64a6380b9c14a 100644
GIT binary patch
literal 32686
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
CJz2{D
literal 31475
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
W*380A2Yfs=<gK*Qn^H-m!2bt@-VC<@
diff --git a/src/site/site.xml b/src/site/site.xml
index 9b7f20f6..c21fdbce 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
- Copyright 2013-2017 CS Systèmes d'Information
+ Copyright 2013-2019 CS Systèmes d'Information
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
@@ -46,6 +46,7 @@
<item name="Direct location" href="/tutorials/direct-location.html" />
<item name="Direct location with DEM" href="/tutorials/direct-location-with-DEM.html" />
<item name="Inverse location" href="/tutorials/inverse-location.html" />
+ <item name="Matlab examples" href="/tutorials/matlab-example.html" />
</menu>
<menu name="Development">
<item name="Contributing" href="/contributing.html" />
--
GitLab