1starpkg(1)                  General Commands Manual                 starpkg(1)
2
3
4

NAME

6       starpkg - convert a StarPlot data set to StarPlot file format
7

SYNOPSIS

9       starpkg [ --dataset ] data-set [ --dest destination ]
10       starpkg --recurse input-dir [ --dest destination ]
11

DESCRIPTION

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

USAGE

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
29       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
36       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

OPTIONS

45       --dataset, -s
46              Specify  a  directory  or  tar.gz file to use as a StarPlot data
47              set.
48
49       --dest, -d
50              Specify the file or directory in which to output StarPlot-format
51              data files.
52
53       --recurse, -r
54              Specify a directory in which to search for StarPlot data sets.
55

SEE ALSO

57       starplot(1), starconvert(1)
58

AUTHOR

60       Copyright   ©   2000-2002  under  the  GNU  GPL  by  Kevin  B.  McCarty
61       <kmccarty@princeton.edu>.    The    StarPlot    web    page    is    at
62       www.starplot.org.
63
64
65
66
67                                   Nov 2002                         starpkg(1)