Common pen parameters - Revision history

Sfomel at 22:01, 8 April 2014

2014-04-08T22:01:39Z

← Older revision		Revision as of 22:01, 8 April 2014
Line 1:		Line 1:
	Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug]. This page attempts to gather information from the mailing list in a structured and editable form. The information below is from a 2009-03-24 exchange of messages between Sergey and Joe on the rsfuser mailing list.

	To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768.		To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768.

Sfomel at 22:00, 8 April 2014

2014-04-08T22:00:49Z

Sfomel: /* Controlling figure size or aspect ratio */

2011-04-03T16:09:24Z

Controlling figure size or aspect ratio

← Older revision		Revision as of 16:09, 3 April 2011
Line 41:		Line 41:
	</python>		</python>
	==Controlling figure size or aspect ratio==		==Controlling figure size or aspect ratio==
	There are three basic parameters: <tt>screenratio, <tt>screenht</tt>, and <tt>screenwd</tt>. If <tt>screenwd</tt> is not provided, it is calculated as <tt>screenht/screenratio</tt>. The defaults are:		There are three basic parameters: <tt>screenratio</tt>, <tt>screenht</tt>, and <tt>screenwd</tt>. If <tt>screenwd</tt> is not provided, it is calculated as <tt>screenht/screenratio</tt>. The defaults are:
	<pre>		<pre>
	screenratio=0.75		screenratio=0.75

Nick: info from 2005-03-28 blog post

2009-06-26T09:13:37Z

info from 2005-03-28 blog post

← Older revision		Revision as of 09:13, 26 June 2009
Line 40:		Line 40:
	(width,height,ppi,xcen,ycen,vppen,gif)		(width,height,ppi,xcen,ycen,vppen,gif)
	</python>		</python>
			==Controlling figure size or aspect ratio==
			There are three basic parameters: <tt>screenratio, <tt>screenht</tt>, and <tt>screenwd</tt>. If <tt>screenwd</tt> is not provided, it is calculated as <tt>screenht/screenratio</tt>. The defaults are:
			<pre>
			screenratio=0.75
			screenht=10.24
			</pre>
			For a finer control, you can use <tt>xinch=</tt> (horizontal size), <tt>yinch=</tt> (vertical size), <tt>xll=</tt>, <tt>xur=</tt>, <tt>yll=</tt>, <tt>yur=</tt> (x and y coordinates for lower-left and upper-right corners). If not provided, they are calculated from <tt>screenht</tt> and <tt>screenwd</tt>.

			These parameters apply to sfcontour, sfgraph, sfgrey, sfplotrays, and sfwiggle.

Nick: advice from 2009-06-25 Sergey e-mail

2009-06-25T07:43:29Z

advice from 2009-06-25 Sergey e-mail

← Older revision		Revision as of 07:43, 25 June 2009
Line 2:		Line 2:

	To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768.		To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768.

			Because vplot uses a 2-byte representation for integers, it cannot deal with numbers greater than 256*128-1=32767. Feeding into vplot datasets with n1 or n2 greater than this number will result in an error.

	Vplot has two output "styles"... <tt>size=absolute</tt> and <tt>size=relative</tt>		Vplot has two output "styles"... <tt>size=absolute</tt> and <tt>size=relative</tt>

Nick at 22:50, 23 June 2009

2009-06-23T22:50:28Z

← Older revision		Revision as of 22:50, 23 June 2009
Line 1:		Line 1:
	Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug]		Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug]. This page attempts to gather information from the mailing list in a structured and editable form. The information below is from a 2009-03-24 exchange of messages between Sergey and Joe on the rsfuser mailing list.

	~~This page attempts to gather information from the mailing list in a structured and editable form.~~		To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768.

	~~Generic options for all these programs: "~~To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768."

	~~From Joe's 2009-03-24 message to rsf-user:~~

	Vplot has two output "styles"... <tt>size=absolute</tt> and <tt>size=relative</tt>		Vplot has two output "styles"... <tt>size=absolute</tt> and <tt>size=relative</tt>
Line 34:		Line 30:

	The "size=a" says "an inch is an inch", so that as you shrink the window to just get the part of the plot you are interested in, the plot stays the same size and doesn't shrink as well.		The "size=a" says "an inch is an inch", so that as you shrink the window to just get the part of the plot you are interested in, the plot stays the same size and doesn't shrink as well.

	~~From Sergey's 2009-03-24 reply:~~

	The Madgascar "vplot2gif" does something similar but in Python:		The Madgascar "vplot2gif" does something similar but in Python:

Nick at 22:48, 23 June 2009

2009-06-23T22:48:49Z

Nick: New page: Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug] This page attempts to ga...

2009-06-23T22:47:57Z

New page: Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug] This page attempts to ga...

New page

Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug]

This page attempts to gather information from the mailing list in a structured form.

Generic options for all these programs: "To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768."

From Joe's 2009-03-24 message to rsf-user:

Vplot has two output "styles"... <tt>size=absolute</tt> and <tt>size=relative</tt>

In size=absolute the output device has a specified size associated with it, and an inch is really an inch.

If size=relative vplot uses the largest 4 wide by 3 tall rectangle that fits within the device screen. That rectangle is 10.24 inches high and 10.24 * 4 / 3 = 13.653 inches wide.

Most devices set "size=relative" as the default. Traditionally hardcopy devices set "size=absolute" the default. After running through vppen by default the file will be "size=absolute" after that (vpstyle=no turns this feature of vppen off).

The user can override the device's default by putting "size=a" or "size=r" on the command line.

xwmax= ywmax= xwmin= ywmin= are generic vplot options which work in any filter. They override the global clip window, which normally would be
set at the limits of the device screen. They DON'T reset where the "device screen" is.

These can be useful if you want to chop off an extraneous piece of a plot that you don't want, for example chop off unneeded axis labels on a plot.

My guess is you are wanting to "zoom in" on a particular piece of the vplot plotting area. There are generic vplot options for that, too: you can set "xcenter= ycenter=" and vplot will center that coordinate in the middle of the display. You can then use "scale" to zoom in on that piece to make it bigger.

If you really want to be able to set "bounds of the area to rasterize", we could add those as specific options for gdpen or as generic options
to dovplot. But my guess is if the piece you are wanting is small, it doesn't need as many pixels to describe it.

The old SEPlib "vplot2gif" does this by calling vppen to locate the plot on the page (centered at $xcen, $ycen) and see how big it is ($height, $width). It converts the height and width to pixel-size units. It then calls "ppmpen" with the following options:

<bash>
ppmpen n2=$height n1=$width ppi=$ppi size=a xcenter=$xcen ycenter=$ycen
</bash>

The "size=a" says "an inch is an inch", so that as you shrink the window to just get the part of the plot you are interested in, the plot stays the same size and doesn't shrink as well.

From Sergey's 2009-03-24 reply:

The Madgascar "vplot2gif" does something similar but in Python:

run = 'ppmpen break=i n1=%d n2=%d ppi=%d size=a ' \
'xcenter=%g ycenter=%g %s | ' \
'ppmquant 256 | ppmtogif > %s' % \
(width,height,ppi,xcen,ycen,vppen,gif)

← Older revision		Revision as of 22:00, 8 April 2014
Line 25:		Line 25:
	to dovplot. But my guess is if the piece you are wanting is small, it doesn't need as many pixels to describe it.		to dovplot. But my guess is if the piece you are wanting is small, it doesn't need as many pixels to describe it.

	The ~~old SEPlib~~ "vplot2gif" does this by calling vppen to locate the plot on the page (centered at $xcen, $ycen) and see how big it is ($height, $width). It converts the height and width to pixel-size units. It then calls "ppmpen" with the following options:		The "vplot2gif" script does this by calling vppen to locate the plot on the page (centered at $xcen, $ycen) and see how big it is ($height, $width). It converts the height and width to pixel-size units. It then calls "ppmpen" with the following options:

	<bash>		<syntaxhighlight lang="bash">
	ppmpen n2=$height n1=$width ppi=$ppi size=a xcenter=$xcen ycenter=$ycen		ppmpen n2=$height n1=$width ppi=$ppi size=a xcenter=$xcen ycenter=$ycen
	</~~bash~~>		</syntaxhighlight>

	The "size=a" says "an inch is an inch", so that as you shrink the window to just get the part of the plot you are interested in, the plot stays the same size and doesn't shrink as well.		The "size=a" says "an inch is an inch", so that as you shrink the window to just get the part of the plot you are interested in, the plot stays the same size and doesn't shrink as well.

	The Madgascar "vplot2gif" does ~~something similar but~~ in Python:		The Madgascar "vplot2gif" script does it in Python:
	<python>		<syntaxhighlight lang="python">
	run = 'ppmpen break=i n1=%d n2=%d ppi=%d size=a ' \		run = 'ppmpen break=i n1=%d n2=%d ppi=%d size=a ' \
	'xcenter=%g ycenter=%g %s \| ' \		'xcenter=%g ycenter=%g %s \| ' \
	'ppmquant 256 \| ppmtogif > %s' % \		'ppmquant 256 \| ppmtogif > %s' % \
	(width,height,ppi,xcen,ycen,vppen,gif)		(width,height,ppi,xcen,ycen,vppen,gif)
	</~~python~~>		</syntaxhighlight>
	==Controlling figure size or aspect ratio==		==Controlling figure size or aspect ratio==
	There are three basic parameters: <tt>screenratio</tt>, <tt>screenht</tt>, and <tt>screenwd</tt>. If <tt>screenwd</tt> is not provided, it is calculated as <tt>screenht/screenratio</tt>. The defaults are:		There are three basic parameters: <tt>screenratio</tt>, <tt>screenht</tt>, and <tt>screenwd</tt>. If <tt>screenwd</tt> is not provided, it is calculated as <tt>screenht/screenratio</tt>. The defaults are:
Line 48:		Line 48:
	For a finer control, you can use <tt>xinch=</tt> (horizontal size), <tt>yinch=</tt> (vertical size), <tt>xll=</tt>, <tt>xur=</tt>, <tt>yll=</tt>, <tt>yur=</tt> (x and y coordinates for lower-left and upper-right corners). If not provided, they are calculated from <tt>screenht</tt> and <tt>screenwd</tt>.		For a finer control, you can use <tt>xinch=</tt> (horizontal size), <tt>yinch=</tt> (vertical size), <tt>xll=</tt>, <tt>xur=</tt>, <tt>yll=</tt>, <tt>yur=</tt> (x and y coordinates for lower-left and upper-right corners). If not provided, they are calculated from <tt>screenht</tt> and <tt>screenwd</tt>.

	These parameters apply to sfcontour, sfgraph, sfgrey, sfplotrays, and sfwiggle.		These parameters apply to programs such as sfcontour, sfgraph, sfgrey, sfplotrays, and sfwiggle.

← Older revision		Revision as of 22:48, 23 June 2009
Line 1:		Line 1:
	Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug]		Lack of auto-documentation for the common pen parameters [http://sourceforge.net/tracker/?func=detail&aid=2709454&group_id=162909&atid=825645 is considered a bug]

	This page attempts to gather information from the mailing list in a structured form.		This page attempts to gather information from the mailing list in a structured and editable form.

	Generic options for all these programs: "To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768."		Generic options for all these programs: "To control the image size, you can use n1= n2= (size in pixels) aspect= (aspect ratio) ppi=(pixels per inch). The default size is 1024x 768."
Line 17:		Line 17:
	The user can override the device's default by putting "size=a" or "size=r" on the command line.		The user can override the device's default by putting "size=a" or "size=r" on the command line.

	xwmax= ywmax= xwmin= ywmin= are generic vplot options which work in any filter. They override the global clip window, which normally would be		<tt>xwmax= ywmax= xwmin= ywmin=</tt> are generic vplot options which work in any filter. They override the global clip window, which normally would be
	set at the limits of the device screen. They DON'T reset where the "device screen" is.		set at the limits of the device screen. They DON'T reset where the "device screen" is.

Line 38:		Line 38:

	The Madgascar "vplot2gif" does something similar but in Python:		The Madgascar "vplot2gif" does something similar but in Python:
			<python>
	run = 'ppmpen break=i n1=%d n2=%d ppi=%d size=a ' \		run = 'ppmpen break=i n1=%d n2=%d ppi=%d size=a ' \
	'xcenter=%g ycenter=%g %s \| ' \		'xcenter=%g ycenter=%g %s \| ' \
	'ppmquant 256 \| ppmtogif > %s' % \		'ppmquant 256 \| ppmtogif > %s' % \
	(width,height,ppi,xcen,ycen,vppen,gif)		(width,height,ppi,xcen,ycen,vppen,gif)
			</python>