Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

cubefunc

This program will apply a chosen function to the input cube

This program will apply the chosen function to the input cube. The following functions with their corresponding restrictions are available: NOTE: Trig functions requiring angles as the input must be in radians. 
    	FUNCTION       RESTRICTIONS
	cos (x)
	sin (x)
	tan (x)        x cannot equal: 90, 270, -90, -270,
                                       pi/2, 3pi/2, -pi/2, -3pi/2
	arccos(x)      -1.0 < x < 1.0
	arcsin(x)      -1.0 < x < 1.0
	arctan(x)
	1.0 / x        x cannot equal 0.
	sqrt (x)       x must be greater than or equal to 0.
	10 ^ x
	e ^ x
	x ^ y          x is the input cube, y is an input constant
	log (x)        x > 0
	ln (x)         x > 0
	abs(x)

Categories

Related Objects and Documents

Applications

History

Tracie Sucharski2002-10-18 Original version
Tracie Sucharski2002-10-29 If input pixel is a special pixel, output the input value instead of the NULL value.
K Teal Thompson2002-11-22 Add example.
Tracie Sucharski2003-01-28 Removed from Utility category.
K Teal Thompson2003-02-03 Make images smaller. Move "constants" group below "functions" group.
Tracie Sucharski2003-04-03 Added to liens: 1. Add degree and radian radio buttons. 2. Move constants group below functions goup.
Stuart Sides2003-04-04 Fixed problem with isiscvs not checking in the thumb and image directories.
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Tracie Sucharski2004-07-16 Add error checking for cos/sin function. Print number invalid input pixels.
Brendan George2006-09-28 Documentation fixes
Brendan George2007-01-09 Fixed appTest
Steven Lambright2007-08-21 Fixed output to contain valid pvl

Parameters

Files

Cube that is used as input to chosen function (x value). NOTE: For trig functions requiring angles, input must be in radians.
Type cube
File Mode input
Filter *.cub

Cube containing the result of the function.
Type cube
File Mode output
Pixel Type real
Filter *.cub

Functions

This indicates the function to apply to the input cube.
Type string
Default COS
Option List:
Option Brief Description
COScosine Apply the cosine function to the input pixel (x). X must be in radians.

Exclusions

  • Y
SINsine Apply the sine function to the input pixel (x). x must be in radians.

Exclusions

  • Y
TANtangent Apply the tangent function to the input pixel (x). x cannot equal: pi/2, 3pi/2, -pi/2, -3p/2, and must be in radians.

Exclusions

  • Y
ACOSarc cosine Apply the arc cosine function to the input pixel (x). x must be in radians and between -1.0 and 1.0.

Exclusions

  • Y
ASINarc sine Apply the arc sine function to the input pixel (x). x must be in radians and between -1.0 and 1.0.

Exclusions

  • Y
ATANarc tan Apply the arc tangent function to the input pixel.

Exclusions

  • Y
INVinverse Apply the inverse function, 1/x, to the input cube. (x > 0.)

Exclusions

  • Y
SQRTsquare root Take the square root of the input pixel (x). (x > 0.)

Exclusions

  • Y
POW10Power of 10 Take 10 to the power of x (x=input pixel)

Exclusions

  • Y
EXPexponent Take e to the x (x=input pixel) e = 2.7182818284590452353602874713526

Exclusions

  • Y
XTOYx ^ y Calculate x (FROM) to the power of y.

Inclusions

  • Y
LOG10Log base 10(x) Calculate the log 10 of the input pixel (x). (x > 0.)

Exclusions

  • Y
LNNatural log(x) Calculate the natural log of the input pixel (x). (x > 0.)

Exclusions

  • Y
ABSAbsolute value(x) Calculate the absolute value of the input pixel (x).

Exclusions

  • Y

Constants

y value which is only used when FUNCTION=XTOY.
Type double

Example 1

X to Y

This example shows the use of the "x to y" function.

Command Line

You have to use "fr" for the FROM parameter because the parameter FUNCTION starts with an "f", also.
cubefunc fr=../IN/9700r.cub t=OUT/cubefunc fu=xtoy y=3

GUI Screenshot

Cubefunc Gui

Example Gui

Cubefunc Gui

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

Input Image

Input Io image

Input image for cubefunc

Input Io image

Parameter Name: FROM

This is the input image for the cubefunc example.

Output Image

Output image showing results of cubefunc using the X to Y function.

Output image for cubefunc

Output image showing results of cubefunc using the X to Y function.

Parameter Name: TO

This is the "X to Y" output image that results.