1starpkg(1) General Commands Manual starpkg(1)
2
6 starpkg - convert a StarPlot data set to StarPlot file format
7
9 starpkg [ --dataset ] data-set [ --dest destination ]
10 starpkg --recurse input-dir [ --dest destination ]
11
13 On the StarPlot web site are available some packages of data that
14 include both an original data file from NASA, and also a specification
15 file. These packages are referred to as "data sets", from which star‐
16 convert(1) can produce a data file in StarPlot format. For ease of
17 use, this should be done via the starpkg shell script.
18
20 Assuming that data-set is a valid StarPlot data set (either in tar.gz
21 format or a directory resulting from uncompressing the tar.gz file),
22 the `starpkg --dataset' command converts it to a StarPlot-formatted
23 data file. Note that the `--dataset' flag is optional, and the name of
24 the input data set may be specified without it. In order to be a valid
25 StarPlot data set, a directory or tar.gz file must contain at least a
26 valid specification file whose name ends with `.spec' and a flat text
27 data file named `catalog.dat'.
28 If the `--dest' option is omitted, the default location of the output
30 file is the first of the directories /usr/share/starplot, $PWD, $HOME
31 in which the user has write permissions. If `--dest' is omitted or
32 destination is a directory, the name of the output file will by default
33 be ${specfilename%.spec}.stars. For instance, a data set containing
34 gliese.3.spec will produce a file named gliese.3.stars.
35 The `starpkg --recurse' form of the command executes the above action
37 for every StarPlot data set contained in input-dir, placing the result‐
38 ing StarPlot data files to the directory destination. (If the --dest
39 option is omitted, the default destination directory is chosen as
40 above.) This form of the starpkg command is most useful when a new
41 version of StarPlot has been installed and you wish to regenerate all
42 StarPlot data files from data sets using the new starconvert program.
43
45 --dataset, -s
46 Specify a directory or tar.gz file to use as a StarPlot data
47 set.
48 --dest, -d
50 Specify the file or directory in which to output StarPlot-format
51 data files.
52 --quiet, -q
54 Print only fatal errors to the terminal.
55 --recurse, -r
57 Specify a directory in which to search for StarPlot data sets.
58 --starconvert-option option
60 Pass option through to starconvert. If you wish to pass more
61 than one option (or an option that takes a following argument),
62 you should give this flag multiple times, once for each starcon‐
63 vert option or argument.
64 --verbose, -v
66 Print all starconvert output to the terminal.
67
69 starplot(1), starconvert(1)
70
72 Copyright © 2000-2002 under the GNU GPL by Kevin B. McCarty
73 <starplot@starplot.org>. The StarPlot web page is at www.starplot.org.
74 Nov 2002 starpkg(1)