|
|
StarPlot 0.95.5 (Default branch)
05-16-2008
StarPlot is a GTK-based program, written in C++,which can be used interactively to viewthree-dimensional perspective charts of stars.Charts can be recentered, rotated, or zoomed in orout with a mouse click (this can also, of course,be done via dialog boxes for more precision).Stars may be viewed (or ignored) by spectral classand absolute magnitude. Other features includesupport for both celestial and galactic coordinatesystems, the ability to display extendednon-stellar objects, and a pop-upHertzsprung-Russell diagram. StarPlot is alsopackaged with starconvert, a utility whichconverts line-oriented stellar data records toStarPlot format. Most star data files available onthe Internet can be converted this way if a shortfile describing the original file format isprovided to starconvert. License: GNU General Public License (GPL)Changes:|
|
starpkg(1) General Commands Manual starpkg(1) NAME
starpkg - convert a StarPlot data set to StarPlot file format SYNOPSIS
starpkg [ --dataset ] data-set [ --dest destination ] starpkg --recurse input-dir [ --dest destination ] DESCRIPTION
On the StarPlot web site are available some packages of data that include both an original data file from NASA, and also a specification file. These packages are referred to as "data sets", from which starconvert(1) can produce a data file in StarPlot format. For ease of use, this should be done via the starpkg shell script. USAGE
Assuming that data-set is a valid StarPlot data set (either in tar.gz format or a directory resulting from uncompressing the tar.gz file), the `starpkg --dataset' command converts it to a StarPlot-formatted data file. Note that the `--dataset' flag is optional, and the name of the input data set may be specified without it. In order to be a valid StarPlot data set, a directory or tar.gz file must contain at least a valid specification file whose name ends with `.spec' and a flat text data file named `catalog.dat'. If the `--dest' option is omitted, the default location of the output file is the first of the directories /usr/share/starplot, $PWD, $HOME in which the user has write permissions. If `--dest' is omitted or destination is a directory, the name of the output file will by default be ${specfilename%.spec}.stars. For instance, a data set containing gliese.3.spec will produce a file named gliese.3.stars. The `starpkg --recurse' form of the command executes the above action for every StarPlot data set contained in input-dir, placing the resulting StarPlot data files to the directory destination. (If the --dest option is omitted, the default destination directory is chosen as above.) This form of the starpkg command is most useful when a new version of StarPlot has been installed and you wish to regenerate all StarPlot data files from data sets using the new starconvert program. OPTIONS
--dataset, -s Specify a directory or tar.gz file to use as a StarPlot data set. --dest, -d Specify the file or directory in which to output StarPlot-format data files. --quiet, -q Print only fatal errors to the terminal. --recurse, -r Specify a directory in which to search for StarPlot data sets. --starconvert-option option Pass option through to starconvert. If you wish to pass more than one option (or an option that takes a following argument), you should give this flag multiple times, once for each starconvert option or argument. --verbose, -v Print all starconvert output to the terminal. SEE ALSO
starplot(1), starconvert(1) AUTHOR
Copyright (C) 2000-2002 under the GNU GPL by Kevin B. McCarty <starplot@starplot.org>. The StarPlot web page is at www.starplot.org. Nov 2002 starpkg(1)