Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

starconvert(1) [debian man page]

starconvert(1)						      General Commands Manual						    starconvert(1)

NAME

       starconvert - convert text data files to StarPlot format

SYNOPSIS

       starconvert [ options ] spec-file input-file [ output-file ]

DESCRIPTION

       Although  many  stellar	data  files are publicly available on the Internet from NASA and other astronomical organizations, there is no set
       format for these files.	The program starconvert acts as a buffer between this confusion and the format in  which  StarPlot  requires  data
       files.	To do so, it uses a specification file that details how various fields of stellar data (name, distance, right ascension, etc.) may
       be extracted from the original data file.

       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 can produce a data file in StarPlot format.  For ease of use,
       this should be done via the starpkg(1) shell script.

       The starconvert command uses the specifications in spec-file to convert input-file to StarPlot data format and writes the results  to  out-
       put-file  if  specified, or standard output if not.  The first two arguments are required.  Exactly ONE may be replaced with a dash `-' for
       reading from standard input.

OPTIONS

       --     Signals the end of the options.  This allows you to use a spec-file whose filename begins with the '-' character.

       --add-sun
	      Add an entry for the Sun to the generated StarPlot-format data file, if it is not already present in the	original  raw  data  file.
	      This is the default behavior, so this flag has an effect only if it reverses an earlier --no-add-sun flag.

       --no-add-sun
	      Do  not  add  an	entry  for the Sun to the generated StarPlot-format data file, unless it is present in the original raw data file.
	      Adding the Sun is otherwise done by default, since most star catalogs do not include it.

SPECIFICATION FILES

       For detailed information on how to write a specification file, see the example file listed below.  Be aware that I  expect  to  change  the
       default format of starconvert spec files after version 1.0, although starconvert will remain backwards-compatible.

FILES

       /usr/share/doc/starplot/ - Contains documentation
       /usr/share/doc/starplot/examples/example.spec - Example specification file

SEE ALSO

       starplot(1), starpkg(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							    starconvert(1)

Check Out this Related Man Page

AUCONVERT(1)						      General Commands Manual						      AUCONVERT(1)

NAME

       auconvert - perform various conversion operations on sound files

SYNOPSIS

       auconvert  [-file  <format>]  [-data  <format>] [-rate <sample rate>] [-comment <comment>] [-raw <data format> <num tracks>] [-volume <per-
       cent>|`max'] [-?] [<input file>] [<output file>]

DESCRIPTION

       The auconvert program can be used to convert from one sound file format, and/or data format to another.	It can also  change  the  comment,
       sampling  rate,	and volume of a sound file.  Finally, auconvert can be used to convert raw audio data into a sound file.  If no input file
       name is given, standard input will be used.  If no output file name is given, the original file will be replaced by the converted  file	or
       standard out will be used if the input is coming from standard input.

OPTIONS

       The following options may be used with auconvert:

       -file format
	       The output file format.	The -? option will display a list of valid file formats.

       -data format
	       The  output  data  format.   The  -? option will display a list of valid data formats.  Note that each file format may only support
	       selected data formats.

       -rate sample rate
	       The output sampling rate (in hertz).

       -comment comment
	       The comment to be stored in the output file.

       -volume <percent>|`max'
	       The volume option can be used in two ways.  If the argument is a percentage, the output file volume will be converted to the speci-
	       fied  percentage of the input volume.  If the argument is the string `max', the output file volume will be converted to its maximum
	       level.

       -raw <data format> <num tracks>
	       This option is used to convert raw audio data into a sound file.  <data format> is the data format of the raw data.   <num  tracks>
	       specifies the number of tracks in the raw data.	You must also use the -file and -rate options when converting raw data.

       -?      Displays a usage message and a list of supported file and data formats.

SEE ALSO

       nas(1), auedit(1)

COPYRIGHT

       Copyright 1993, 1994 Network Computing Devices, Inc.

AUTHOR

       Greg Renda, Network Computing Devices, Inc.

								       1.9.3							      AUCONVERT(1)
Man Page