pdl::graphics::lut(3) [suse man page]

LUT(3)							User Contributed Perl Documentation						    LUT(3)

NAME

       PDL::Graphics::LUT - provides access to a number of look-up tables

SYNOPSIS

	use PDL::Graphics::PGPLOT;
	use PDL::Graphics::LUT;

	# what tables are available
	my @tables = lut_names();

	# get the reversed colour table 'smooth',
	# with the gamma intensity ramp
	my ( $l, $r, $g, $b ) = lut_data( 'smooth', 1, 'gamma' );

	# use the table idl5 in ctab
	ctab( lut_data('idl5') );

DESCRIPTION

       PDL::Graphics::LUT contains a number of colour look-up tables (in rgb format) and intensity ramps, and provides routines to access this
       data.  The format of the data is suitable for use by "ctab" in PDL::Graphics::PGPLOT.

       Unlike the initial release of the package, the data tables are now stored within the PDL distribution as FITS files (see $tabledir and
       $rampdir), rather than in the module itself.  Changes to these directories will be picked up on the next call to one of the package
       functions.

FUNCTIONS

   lut_names()
       Return, as a list, the names of the available colour tables.

	@tables = lut_names();

   lut_ramps()
       Return, as a list, the names of the available intensity ramps.

	@ramps = lut_ramps();

   lut_data()
       Load in the requested colour table and intensity ramp.

	( $l, $r, $g, $b ) = lut_data( $table, [ $reverse, [ $ramp ] ] );

       Returns the levels and r, g, b components of the colour table $table. If $reverse is 1 (defaults to 0 if not supplied), then the r, g, and
       b components are reversed before being returned.  If not supplied, $ramp defaults to "ramp" (this is a linear intensity ramp).

       The returned values are piddles containing values in the range 0 to 1 inclusive, and are floats.

VARIABLES

   $tabledir
       The directory in which the colour tables (in rgb format) are stored.

   $rampdir
       The directory in which the intensity ramps are stored.

   $suffix
       The suffix for the data files in $tabledir and $rampdir.

FURTHER INFORMATION

       The colour tables were taken from the STARLINK GAIA package, and are provided under the GNU copyleft.  See http://star-www.rl.ac.uk/ and
       http://star-www.dur.ac.uk/~pdraper/ for more details.

AUTHOR

       Doug Burke (djburke@cpan.org), with thanks to Peter Draper/STARLINK for providing the colour-table data, and Christian Soeller and Karl
       Glazebrook for their help.

       All rights reserved. There is no warranty. You are allowed to redistribute this software / documentation under certain conditions. For
       details, see the file COPYING in the PDL distribution. If this file is separated from the PDL distribution, the copyright notice should be
       included in the file.

perl v5.12.1							    2009-10-17								    LUT(3)

TriD::Contours(3pm)					User Contributed Perl Documentation				       TriD::Contours(3pm)

NAME

	 PDL::Graphics::TriD::Contours - 3D Surface contours for TriD

SYNOPSIS

	   # A simple contour plot in black and white

	   use PDL::Graphics::TriD;
	   use PDL::Graphics::TriD::Contours;
	   $size = 25;
	   $x = (xvals zeroes $size,$size) / $size;
	   $y = (yvals zeroes $size,$size) / $size;
	   $z = (sin($x*6.3) * sin($y*6.3)) ** 3;
	   $data=new PDL::Graphics::TriD::Contours($z,
		      [$z->xvals/$size,$z->yvals/$size,0]);
	   PDL::Graphics::TriD::graph_object($data)

FUNCTIONS

   new()
       Define a new contour plot for TriD.

	 $data=new PDL::Graphics::TriD::Contours($d,[$x,$y,$z],[$r,$g,$b],$options);

       where $d is a 2D pdl of data to be contoured. [$x,$y,$z] define a 3D map of $d into the visualization space [$r,$g,$b] is an optional [3,1]
       piddle specifing the contour color and $options is a hash reference to a list of options documented below.  Contours can also be colored by
       value using the set_color_table function.

	 ContourInt  => 0.7  # explicitly set a contour interval
	 ContourMin  => 0.0  # explicitly set a contour minimum
	 ContourMax  => 10.0 # explicitly set a contour maximum
	 ContourVals => $pdl # explicitly set all contour values
	 Label => [1,5,$myfont] # see addlabels below
	 Font =>  $font      # explicitly set the font for contour labels

	 If ContourVals is specified ContourInt, ContourMin, and ContourMax
	 are ignored.  If no options are specified, the algorthym tries to
	 choose values based on the data supplied.  Font can also be specified or
	 overwritten by the addlabels() function below.

   addlabels()
       Add labels to a contour plot

	 $contour->addlabels($labelint,$segint,$font);

       $labelint is the integer interval between labeled contours.  If you have 8 countour levels and specify $labelint=3 addlabels will attempt
       to label the 1st, 4th, and 7th contours.  $labelint defaults to 1.

       $segint specifies the density of labels on a single contour level.  Each contour level consists of a number of connected line segments,
       $segint defines how many of these segments get labels.  $segint defaults to 5, that is every fifth line segment will be labeled.

   set_colortable($table)
       Sets contour level colors based on the color table.

       $table is passed in as either a piddle of [3,n] colors, where n is the number of contour levels, or as a reference to a function which
       expects the number of contour levels as an argument and returns a [3,n] piddle.	It should be straight forward to use the
       PDL::Graphics::LUT tables in a function which subsets the 256 colors supplied by the look up table into the number of colors needed by
       Contours.

   coldhot_colortable()
       A simple colortable function for use with the set_colortable function.

       coldhot_colortable defines a blue red spectrum of colors where the smallest contour value is blue, the highest is red and the others are
       shades in between.

perl v5.14.2							    2011-03-30						       TriD::Contours(3pm)