Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation

center

Standard View | TOC | Home

Compute the center of mass of a single-band cube

Description
Categories
Groups
Examples
History

Description

This program computes the sample and line of the center of mass (weighted by pixel value) of a single-band cube. The sample and line of the centroid, as well as the offset from the image center, are output in PVL. In addition if the TO parameter is specified this program will ouput a single-band cube of the same size with the center of mass of the input cube at the center of the image frame. The primary purpose of this program is to align multiple images of an object for a movie, such as images taken on approach. This program is best used with objects against a dark background.

Categories

Related Objects and Documents

Applications

Parameter Groups

Files

Name Description
FROM Input cube/image to center
TO Output cube
INTERP Interpolation used for Transformation
MINIMUM Minimum DN value to consider
MAXIMUM Maximum DN to consider in computation

Files: FROM

Description

Use this parameter to select the filename. Only one band is allowed in the input cube.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

If specified this file will contain the results of the centered cube.

Type cube
File Mode output
Internal Default None
Inclusions
  • INTERP
Filter *.cub

Files: INTERP

Description

This will be the interpolation type used to get the output file in either the translate or warp application. Defaults to CUBICCONVOLUTION.

Type string
Default CUBICCONVOLUTION
Option List:
Option Brief Description
NEARESTNEIGHBOR Nearest Neighbor Interpolation Nearest Neighbor Interpolation will be used in the transformation to create the output file.
BILINEAR Bilinear Interpolation Bilinear Interpolation will be used in the transformation to create the output file.
CUBICCONVOLUTION Cubic Convolution Interpolation Cubic Convolution Interpolation will be used in the tranformation to create the output file.

Files: MINIMUM

Description

Minimum DN in the image to consider for computation of the center of mass. This can be helpful to eliminate background data.

Type double
Internal Default ValidMin
Less Than
  • MAXIMUM

Files: MAXIMUM

Description

Maximum DN to consider in computation of center of mass. This can be used to eliminate high saturation that would otherwise bias the centroid calculation.

Type double
Internal Default ValidMax

Examples

Example 1

Centering object against dark background.

Description

This example shows centering a body against a dark background.

Command Line

center center from=EN0131836960M_iof.cub to=centered.cub
Center the input image about the center of mass using the default interpolation.

GUI Screenshot

Mirror Gui

Example Gui

Screenshot of GUI with parameters filled in to perform a center operation on the input image.

Input Image

Input image

Input image for center

Parameter Name: FROM

This is the 512 by 512 input image for the center example.

Output Image

Output image showing results of the center application.

Output image for mirror

Parameter Name: TO

This is the 512 by 512 output image that results.

History

Kris Becker2014-12-25 Original version
Jeffrey Covington2015-02-19 Added more documentation and restricted center to single-band cubes.