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 for- mat 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/local/share/starplot, $PWD, $HOME in which the user has write permissions. If `--dest' is omitted or destina- tion is a directory, the name of the output file will by default be ${spec- filename%.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 op- tion 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)
NAME | SYNOPSIS | DESCRIPTION | USAGE | OPTIONS | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=starpkg&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>