Search Help
Global Change Master Directory (GCMD)
Remap: A reprojection tool of geolocated data between various grids
Entry ID: ICARE_remap

Abstract: Remap ensures reprojection of geolocated data between various grids of satellite-embedded instruments.

The first argument is the user's chosen reference dataset. A dataset is specified by its name followed by the name of the file where it is to be found, using the syntax : dataset@file. The dataset is expected to be a 2-dimensional array. Following dataset arguments will be remapped over the reference dataset geometry (using a simple nearest-pixel policy for the time being, more clever reprojection policies may be implemented in future releases). Reprojected datasets will be put in a common HDF file, along with the reference dataset and its geolocation data (latitudes, longitudes and acquisition times of each reference pixel). Distances and time differences between reprojected pixels and their references may also be stored at the user's will.

The user is given the ability to rename datasets to give them better names in the output file. This functionality may also be used to resolve collisions between input dataset names. The syntax is straightforward: old_dataset_name/new_dataset_name@input_file.

In a few cases (e.g., MODIS), some datasets are 3-dimensional arrays, which are stacks of 2-dimensional arrays indexed by a plane number (typically a channel number). In this case, the user is to specify the plane number between brackets, e.g. dataset[1]@file. The convention adopted here is that the first plane is indexed by one, not by zero.

Higher-dimensional datasets are currently not supported.

For the time being, only a few satellite products are supported, namely MODIS (on AQUA and TERRA), IIR (on CALIPSO) and SEVIRI (on METEOSAT-8). More products are intended to be integrated in the future (an issue is the diversity of formats and conventions in this applicative domain).

remap will yeld an exit code of zero on success. Any other value means failure. Error messages are to be sent to the standard error output. Verbose messages (displayed when the option -v is set) will be sent to the standard output.

Related URL
Description: Download Remap.

ISO Topic Category

AQUA >Earth Observing System, AQUA    [Information]
TERRA >Earth Observing System, TERRA (AM-1)    [Information]
CALIPSO >Cloud-Aerosol Lidar and Infrared Pathfinder Satellite Observations    [Information]

MODIS >Moderate-Resolution Imaging Spectroradiometer    [Information]
IIR >Imaging Infrared Radiometer    [Information]
SEVIRI >Spinning Enhanced Visible and Infrared Imager    [Information]

ICARE >Interactions Clouds Aerosols Radiations Etc    [Information]

This is an early version of the software. While main functionalities are implemented and the software may be used as is to perform remapping, a lot of bugs surely still wait to get revealed.

Please report any bug you could find to

Use Constraints
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

Image Analysis
Geospatial Data
Geolocated Data
Satellite Data

Phone: 33-0-3-20-33-59-79
Email: fabrice.ducos at
Contact Address:
Université des Sciences et Technologies de Lille
City: Villeneuve d'Ascq Cedex
Postal Code: 59655
Country: France

Phone: 301-851-8113
Email: Tyler.B.Stevens at
Contact Address:
5700 Rivertech Court
City: Riverdale
Province or State: MD
Postal Code: 20737
Country: USA

Extended Metadata Properties
(Click to view more)

Creation and Review Dates
SERF Creation Date: 2010-03-17
SERF Last Revision Date: 2017-12-04