Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CONVERTTYPE(1)			  User Commands 		  CONVERTTYPE(1)

NAME
     ConvertType - convert known data types to each other

SYNOPSIS
     astconvertt [OPTION...] InputFile1 [InputFile2] ... [InputFile4]

DESCRIPTION
     ConvertType is part of GNU Astronomy Utilities 0.24.  ConvertType will con-
     vert  any of the known input formats to any other of the known formats. The
     output file will have the same number of pixels.

     For more information, please run any of the following commands. In particu-
     lar the second contains a very comprehensive explanation  of  ConvertType's
     invocation: expected input(s), output(s), and a full description of all the
     options.

     All options and their values:
	    $ astconvertt -P

     Inputs/Outputs and options:
	    $ info astconvertt

     Full section in manual/book:
	    $ info ConvertType

     Full Gnuastro manual/book:
	    $ info gnuastro

     If  you  couldn't	find  your answer in the manual, you can get direct help
     from experienced Gnuastro	users  and  developers.  For  more  information,
     please run:

	    $ info help-gnuastro

     ConvertType options:

	    Input:

     -g, --globalhdu=STR/INT
	    Use this HDU for all inputs, ignore '--hdu'.

     -h, --hdu=STR/INT
	    FITS input HDU, multiple calls possible.

     -I, --ignorecase
	    Ignore case in matching/searching columns.

     --searchin=STR
	    Select column(s): 'name', 'unit', 'comment'.

     --stdintimeout=INT
	    Micro-seconds to wait for standard input.

	    Output:

     --bordercolor=STR
	    Name of color to use for the border.

     --cmappgfplots
	    Color map to include in PGFPlots (in LaTeX).

     --colormap=STR[,FLT]
	    Color map when only a single channel is given.

     -D, --dontdelete
	    Don't delete output if it exists.

     -K, --keepinputdir
	    Keep input directory for automatic output.

     -l, --cmapblankcolor=STR
	    Blank color name in color maps.

     --outfitsnocommit
	    No Git commit in 0-th HDU of output FITS.

     --outfitsnoconfig
	    No metadata in 0-th HDU of output FITS.

     --outfitsnodate
	    No 'DATE' in 0-th HDU of output FITS.

     --outfitsnoversions
	    No versions in 0-th HDU of output FITS.

     -o, --output=STR
	    Output filename or suffix.

     --rgbtohsv
	    Convert RGB input into HSV (in FITS output)

     -u, --quality=INT
	    Quality of output JPEG image (1 to 100).

     --wcslinearmatrix=STR
	    WCS linear matrix of output ('pc' or 'cd').

     -w, --widthincm=FLT
	    Width in units of centimeters.

     -x, --hex
	    Hexadecimal encoding in EPS. Default: ASCII85.

	    Flux:

     -A, --forcemin
	    Force --fluxmin, even when smaller than min.

     -B, --forcemax
	    Force --fluxmax, even when larger than max.

     -c, --change=STR
	    Change pixel values 'from_1:to_1,from_2:to_2'.

     -C, --changeaftertrunc
	    First truncate then change pixel values.

     -H, --fluxhigh=FLT
	    Higher flux truncation value.

     -i, --invert
	    Invert the values in JPEG and EPS/PDF.

     -L, --fluxlow=FLT
	    Lower flux truncation value.

     -m, --maxbyte=INT
	    Maximum byte value for all color channels.

	    Vector graphics (only for EPS or PDF outputs)

     -b, --borderwidth=INT
	    Border width in units of points (1/72 inch).

     --listcolors
	    List names and RGB info of all colors.

     --listfonts
	    List names of available fonts.

     --markcolor=STR
	    Name or Number of col. with mark color.

     --markfont=STR
	    Name or Num. of col. with mark font name.

     --markfontsize=STR
	    Name or Num. of col. with mark font size.

     --marklinewidth=STR
	    Name or Number of col. with line width.

     --markrotate=STR
	    Name or Num. of col. with mark rotation.

     --marks=STR
	    Name of mark information table.

     --markshape=STR
	    Name or Number of col. with mark shapes: circle (1), plus (2), cross
	    (3), ellipse (4), point(5), square (6) rectangle (7) and line (8).

     --markshdu=STR
	    HDU in '--marks' (if its a FITS file).

     --marksize=STR[,STR]
	    Name or Number of cols. with mark size(s).

     --marktext=STR
	    Name or Num. of col. with mark text.

     --marktextprecision=INT
	    Number decimals when text is float column.

     -O, --mode=STR
	    Coordinate mode for marks ('wcs' or 'img').

     -r, --markcoords=STR,STR
	    Name or Number of columns with coordinates.

     --showfonts
	    Show all fonts in a PDF.

     --sizeinarcmin
	    Size col. values are in arcmin (in WCS-mode).

     --sizeinarcsec
	    Size col. values are in arcsec (in WCS-mode).

     --sizeinpix
	    Size col. values are in pixels (in WCS-mode).

	    Operating modes:

     -?, --help
	    give this help list

     --checkconfig
	    List all config files and variables read.

     --cite
	    BibTeX citation for this program.

     --config=STR
	    Read configuration file STR immediately.

     --config-prefix=STR
	    Custom prefix of option names config files.

     --lastconfig
	    Do not parse any more configuration files.

     --log  Information about output(s) in a log file.

     --minmapsize=INT
	    Min. bytes to avoid RAM automatically.

     -N, --numthreads=INT
	    Number of CPU threads to use.

     --onlyversion=STR
	    Only run if the program version is STR.

     -P, --printparams
	    Print parameter values to be used and abort.

     --quietmmap
	    Don't print mmap'd file's name and size.

     -q, --quiet
	    Only report errors, remain quiet about steps.

     -S, --setdirconf
	    Set default values for this directory and abort.

     --usage
	    give a short usage message

     -U, --setusrconf
	    Set default values for this user and abort.

     -V, --version
	    print program version

     Mandatory	or  optional arguments to long options are also mandatory or op-
     tional for any corresponding short options.

     GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/

REPORTING BUGS
     Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT
     Copyright (C) 2015-2025 Free Software Foundation, Inc.  License GPLv3+: GNU
     General public license version 3 or later.
     This is free software: you are free to change and redistribute  it.   There
     is NO WARRANTY, to the extent permitted by law.

     Written/developed by Mohammad Akhlaghi

SEE ALSO
     The  full	documentation for ConvertType is maintained as a Texinfo manual.
     If the info and ConvertType programs are properly installed at  your  site,
     the command

	    info ConvertType

     should give you access to the complete manual.

GNU Astronomy Utilities 0.24	  November 2025 		  CONVERTTYPE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=astconvertt&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help