ISIS Application Documentation
circle  Standard View  TOC  Home 
Trims data outside of a circle
Description
Categories
Groups
Examples
History
Name  Description 

FROM  Input cube to trim 
TO  Output cube 
Name  Description 

DEFINITION  Center and Radius 
Name  Description 

SAMPLE  Sample coordinate of circle 
LINE  Line coordinate of circle 
RADIUS  Radius of the circle 
Name  Description 

SAMP1  First sample coordinate on the circle 
LINE1  First line coordinate on the circle 
SAMP2  Second sample coordinate on the circle 
LINE2  Second line coordinate on the circle 
SAMP3  Third sample coordinate on the circle 
LINE3  Third line coordinate on the circle 
Use this parameter to select the filename. All bands within the file will be trimmed.
Type  cube 

File Mode  input 
Filter  *.cub 
This file will contain the results of the circle trim.
Type  cube 

File Mode  output 
Type  string  

Default  CENTERRAD  
Option List: 

This defines the sample coordinate at the center of the circle. It can be negative or greater than the number of samples in the cube.
Type  double 

Internal Default  Middle sample 
This defines the line coordinate at the center of the circle. It can be negative or greater than the number of lines in the cube.
Type  double 

Internal Default  Middle line 
This defines the radius of the circle. Pixels outside the radius of the circle centered at (SAMPLE,LINE) will be trimmed. The default value is the lesser of half the samples or half the lines.
Type  double 

Internal Default  Half the image size 
Minimum  1.0 (inclusive) 
This defines the sample coordinate of a point on the circle.
Type  double 

Default  0 
This defines the line coordinate of a point on the circle.
Type  double 

Default  0 
This defines the sample coordinate of a point on the circle.
Type  double 

Default  0 
This defines the line coordinate of a point on the circle.
Type  double 

Default  0 
This defines the sample coordinate of a point on the circle.
Type  double 

Default  0 
This defines the line coordinate of a point on the circle.
Type  double 

Default  0 
Taking all defaults
Example GUI Screenshot of GUI with parameters filled in to perform the default circle operation 
Input image for circle
Parameter Name:
FROM This is the input image for the default example of circle. 
Output image for circle
Parameter Name:
TO This is the output image for circle. Notice the NULL values in the corners of this image. 
Small centered circle
Example GUI Screenshot of GUI with parameters filled in to perform a circle operation with a radius of 150 
Input image for circle
Parameter Name:
FROM Input image 
Circle radius smaller than image
Parameter Name:
TO Output image for circle radius = 150 on a 500 by 500 image 
Off centered
Example GUI Screenshot of GUI with parameters filled in to perform a circle operation with a radius of 200 and centered on line/sample 125/375 
Input image for circle
Parameter Name:
FROM This is the input image for the default example of circle. 
Output image off centered example of circle
Parameter Name:
TO This is the output image for circle. Notice the NULL values of this image. 
Kay Edwards  19860203  Original version 
Jeff Anderson  20020619  Ported to Isis 3.0 
Kim Sides  20030513  Added application test 
Stuart Sides  20030516  Modified schema location from astogeology... to isis.astrogeology..." 
Stuart Sides  20030729  Modified filename parameters to be cube parameters where necessary 
Steven Lambright  20080512  Removed references to CubeInfo 
Kimberly Oyama  20120525  Added the functionality of circle2; the user can define a circle by three points on its edge instead of the center and radius. Fixes #518 