static void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stderr);
fprintf(stderr, "\nUsage: %s\n"
" [-p <port>] (default 6789)\n"
" [-f <filename-pattern>] (default solved.%%02i)\n",
progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -w <WCS input file>\n"
" ( -L: just list the items in the field\n"
" OR -o <image output file; \"-\" for stdout> )\n"
" [-p]: write PPM output - default is PNG\n"
" ( [-i <PPM input file>]\n"
" OR [-W <width> -H <height>] )\n"
" [-s <scale>]: scale image coordinates by this value before plotting.\n"
" [-N]: plot NGC objects\n"
" [-F <fraction>]: minimum NGC size, relative to image size (default 0.02)\n"
" [-C]: plot constellations\n"
" [-B]: plot named bright stars\n"
" [-D]: plot HD objects\n"
" [-d]: path to HD catalog\n"
" [-b <number-of-bright-stars>]: just plot the <N> brightest stars\n"
" [-c]: only plot bright stars that have common names.\n"
" [-j]: if a bright star has a common name, only print that\n"
" [-x]: plot only white text"
" [-v]: be verbose\n"
" [-n <width>]: NGC circle width (default 2)\n"
" [-f <size>]: font size.\n"
" [-M]: show only NGC/IC and Messier numbers (no common names)\n"
" [-G <grid spacing in arcmin>]: plot RA,Dec grid\n"
" [-g <r:g:b>]: grid color (default 0.2:0.2:0.2)\n"
" [-J]: print JSON output to stderr\n"
" [-V]: vertical alignment of text labels, \"C\"enter/\"T\"op/\"B\"ottom: default C\n"
" [-O]: horizontal alignment of text labels, \"L\"eft/\"C\"enter/\"R\"ight, default L\n"
"\n", progname);
}
static void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s [options] > output.png\n"
" -i <input-file> Input file (xylist)\n"
" [-o <output-file>] (default: stdout)\n"
" [-I <image> ] Input image on which plotting will occur; PPM format.\n"
" [-p]: Input image is PNG format, not PPM.\n"
" [-P] Write PPM output instead of PNG.\n"
" [-J] Write PDF output.\n"
" [-W <width> ] Width of output image (default: data-dependent).\n"
" [-H <height> ] Height of output image (default: data-dependent).\n"
" [-x <x-offset>] X offset: position of the bottom-left pixel (default: 1).\n"
" [-y <y-offset>] Y offset: position of the bottom-left pixel (default: 1).\n"
" [-X <x-column-name>] X column: name of the FITS column.\n"
" [-Y <y-column-name>] Y column: name of the FITS column.\n"
" [-n <first-obj>] First object to plot (default: 0).\n"
" [-N <num-objs>] Number of objects to plot (default: all).\n"
" [-r <radius>] Size of markers to plot (default: 5.0).\n"
" [-w <linewidth>] Linewidth (default: 1.0).\n"
" [-s <shape>] Shape of markers (default: circle):",
progname);
cairoutils_print_marker_names("\n ");
printf("\n");
printf(" [-C <color>] Color to plot in: (default: white)\n");
cairoutils_print_color_names("\n ");
printf("\n");
printf(" [-b <color>] Draw in <color> behind each marker.\n"
" [-S <scale-factor>] Scale xylist entries by this value before plotting.\n"
" [-e <extension>] FITS extension to read (default 0).\n"
"\n");
}
static void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s -i <quad input> -o <qidx output>\n"
"\n"
" [-c]: run quadfile_check()\n"
" [-v]: add to verboseness\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" [-N <nside>] (default 1)\n"
" [-m (to include a margin of one small healpixel)]\n"
" [-f <format>]: printf format for the output (default %%03i)\n"
" <hp> [<hp> ...]\n",
progname);
}
void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s [options] <index-files>\n"
" -r <ra> (deg)\n"
" -d <dec> (deg)\n"
" -R <radius> (deg)\n"
" [-o <filename>]: save results in FITS table; tag-along columns must be the same in all indices\n"
" [-v]: +verbose\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -1 <WCS first input file>\n"
" -2 <WCS second input file>\n"
" -h\n"
" [-v]: +verbose\n"
"\nPrints x and y coordinates of invariant point"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s [options] <input-FITS-image> <output (target) WCS-file> <output-FITS-image>\n"
" [-E <input image FITS extension>] (default: 0)\n"
" [-w <input WCS file>] (default is to read WCS from input FITS image)\n"
" [-e <input WCS FITS extension>] (default: 0)\n"
" [-x <output WCS FITS extension>] (default: 0)\n"
" [-L <Lanczos order>] (default: nearest-neighbor resampling)\n"
" [-z]: zero out inf/nan input image value\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -w <WCS input file>\n"
" -x <xyls input file>\n"
" -r <rdls input file>\n"
" [-I <background-image>]: background for plots.\n"
" [-v]: verbose\n"
" [-j <pixel-jitter>]: set pixel jitter (default 1.0)\n"
"\n", progname);
}
void print_help(char* progname)
{
BOILERPLATE_HELP_HEADER(stderr);
fprintf(stderr, "Usage: %s\n"
" -r <rdls-output-file>\n"
" [-v]: more verbose\n"
" [-h]: help\n"
" <skdt> [<skdt> ...]\n\n"
"Reads .skdt files. Writes an RDLS containing the star locations.\n",
progname);
}
static void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -i <input-filename> (FITS reference catalog)\n"
" -o <index-filename> (Index file output filename)\n"
" [-u <scale>] upper bound of quad scale (arcmin)\n"
" [-l <scale>] lower bound of quad scale (arcmin)\n"
" [-d <dimquads>] number of stars in a \"quad\".\n"
" [-I <unique-id>] set the unique ID of this index\n\n"
"\nReads skdt, writes {code, quad}.\n\n"
, progname);
}
void print_help(char* progname)
{
BOILERPLATE_HELP_HEADER(stderr);
fprintf(stderr, "Usage: %s\n"
" -r <rdls-output-file>\n"
" [-R]: add quad radius columns to the RDLS file.\n"
" [-h]: help\n"
" <base-name> [<base-name> ...]\n\n"
"Reads index (.quad and .skdt or merged index) files.\n"
"Writes an RDLS containing the quad centers (midpoints of AB), one field per input file.\n\n",
progname);
}
static void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s [options] > output.png\n"
" [-o <output-file>] (default: stdout)\n"
" [-P] Write PPM output instead of PNG.\n"
" [-j] Write JPEG output.\n"
" [-J] Write PDF output.\n"
" [-W <width> ] Width of output image (default: data-dependent).\n"
" [-H <height> ] Height of output image (default: data-dependent).\n"
" [-v]: +verbose\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage:\n"
" %s -o <output-filename-template> [default: ucac4_%%03i.fits]\n"
" [-N <healpix-nside>] (default = 9)\n"
" <input-file> [<input-file> ...]\n"
"\n"
"The output-filename-template should contain a \"printf\" sequence like \"%%03i\";\n"
"we use \"sprintf(filename, output-filename-template, healpix)\" to determine the filename\n"
"to be used for each healpix.\n\n"
"\nNOTE: WE ASSUME THE UCAC4 FILES ARE GIVEN ON THE COMMAND LINE IN ORDER: z001.bz2, z002.bz2, ..., z360.bz2.\n\n",
progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage:\n"
" %s -o <output-filename-template> [eg, usnob10_%%03i.fits]\n"
" [-N <healpix-nside>] (default = 8)\n"
" <input-file> [<input-file> ...]\n"
"\n"
"The output-filename-template should contain a \"printf\" sequence like \"%%03i\";\n"
"we use \"sprintf(filename, output-filename-template, healpix)\" to determine the filename\n"
"to be used for each healpix.\n\n"
"\nNOTE: WE ASSUME THE USNO-B1.0 FILES ARE GIVEN ON THE COMMAND LINE IN ORDER: 000/b0000.cat, 000/b0001.cat, etc.\n\n\n",
progname);
}
static void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -i <input-filename>\n"
" -o <output-filename>\n"
" ( [-b]: build bounding boxes\n"
" OR [-s]: build splitting planes )\n"
" [-t <tree type>]: {double,float,u32,u16}, default u16.\n"
" [-d <data type>]: {double,float,u32,u16}, default u16.\n"
" [-S]: include separate splitdim array\n"
" [-R <target-leaf-node-size>] (default 25)\n"
"\n", progname);
}
static void print_help(const char* progname, bl* opts) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s [options] [<image-file-1> <image-file-2> ...] [<xyls-file-1> <xyls-file-2> ...]\n"
"\n"
"You can specify http:// or ftp:// URLs instead of filenames. The \"wget\" or \"curl\" program will be used to retrieve the URL.\n"
"\n", progname);
printf("Options include:\n");
opts_print_help(opts, stdout, augment_xylist_print_special_opts, NULL);
printf("\n");
printf("Note that most output files can be disabled by setting the filename to \"none\".\n"
" (If you have a sick sense of humour and you really want to name your output\n"
" file \"none\", you can use \"./none\" instead.)\n");
printf("\n\n");
}
void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" ( [-b]: build bounding boxes\n"
" OR [-s]: build splitting planes )\n"
" [-R Nleaf]: number of points in a kdtree leaf node (default 25)\n"
" [-t <tree type>]: {double,float,u32,u16}, default u32.\n"
" [-d <data type>]: {double,float,u32,u16}, default u32.\n"
" [-S]: include separate splitdim array\n"
" [-T <Tycho-2 catalog>]: path to Tycho-2 catalog.\n"
" [-X <Cross-ref file>]: path to Tycho-2 - to - HD cross-ref file.\n"
"\n"
" <input.tsv> <output.fits>\n"
"\n", progname);
}
void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s [options] <input-FITS-catalog> [...]\n"
" -o <output-filename-pattern> with %%i printf-pattern\n"
" [-r <ra-column-name>]: name of RA in FITS table (default RA)\n"
" [-d <dec-column-name>]: name of DEC in FITS table (default DEC)\n"
" [-n <healpix Nside>]: default is 1\n"
" [-m <margin in deg>]: add a margin of this many degrees around the healpixes; default 0\n"
" [-g]: gzip'd inputs\n"
" [-c <name>]: copy given column name to the output files\n"
" [-t <temp-dir>]: use the given temp dir; default is /tmp\n"
" [-b <backref-file>]: save the filenumber->filename map in this file; enables writing backreferences too\n"
" [-v]: +verbose\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -w <WCS input file>\n"
" [-e <extension>] HDU to read (default 0 = primary)\n"
" -i <rdls input file>\n"
" -o <xyls output file>\n"
" [-f <rdls field index>] (default: all)\n"
" [-R <RA-column-name> -D <Dec-column-name>]\n"
" [-t]: just use TAN projection, even if SIP extension exists\n"
" [-L]: force using WCSlib rather than Astrometry.net routines\n"
" [-v]: +verbose\n"
"You can also just specify a single point to convert (printed to stdout)\n"
" [-r <ra>], RA in deg.\n"
" [-d <ra>], Dec in deg.\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -w <WCS input file>\n"
" [-e <extension>] FITS HDU number to read WCS from (default 0 = primary)\n"
" [-t]: just use TAN projection, even if SIP extension exists.\n"
" [-L]: force WCSlib\n"
" [-T]: force WCStools\n"
" [-s]: print sexigesimal too\n"
" -i <xyls input file>\n"
" -o <rdls output file>\n"
" [-f <xyls field index>] (default: all)\n"
" [-X <x-column-name> -Y <y-column-name>]\n"
" [-v]: +verbose\n"
"\n"
"You can also specify a single point to convert (result is printed to stdout):\n"
" [-x <pixel>]\n"
" [-y <pixel>]\n"
"\n", progname);
}
void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stderr);
fprintf(stderr, "Usage: %s [options]\n"
" [-A first-field]\n"
" [-B last-field]\n"
" [-I first-field-filenum]\n"
" [-J last-field-filenum]\n"
" [-L write-leftover-matches-file]\n"
" [-M write-successful-matches-file]\n"
" [-r ratio-needed-to-solve]\n"
" [-f minimum-field-objects-needed-to-solve] (default: no minimum)\n"
" ( [-F]: write out the first sufficient match to surpass the solve threshold.\n"
" or [-a]: write out all matches passing the solve threshold.\n"
" (default is to write out the single best match (largest ratio))\n"
" )\n"
" [-s <solved-server-address>]\n"
" [-S <solved-file-template>]\n"
" <input-match-file> ...\n"
"\n", progname);
}
void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s\n"
" -x <xyls input file>\n"
" [-X <x-column-name> -Y <y-column-name>]\n"
" -r <rdls input file>\n"
" [-R <RA-column-name> -D <Dec-column-name>]\n"
" OR\n"
" -c <correspondences file>\n"
" (default column names: FIELD_X, FIELD_Y, INDEX_RA, INDEX_DEC)\n"
"\n"
" -o <WCS output file>\n"
"\n"
" [-s <SIP-order>] (default is a WCS TAN solution, not SIP)\n"
" [-W <image-width> ] (default: max X position; used for SIP)\n"
" [-H <image-height>] (default: max Y position; used for SIP)\n"
" [-C]: set CRPIX to be the center of the field; SIP only\n"
" [-v]: verbose\n"
"\n", progname);
}
static void print_help(char* progname) {
BOILERPLATE_HELP_HEADER(stdout);
printf("\nUsage: %s <input-filename> <extension> <output-filename>\n"
"\n\n", progname);
}
void printHelp(char* progname) {
BOILERPLATE_HELP_HEADER(stderr);
fprintf(stderr, "\nUsage: %s -o <output-file> <input-file> ...\n"
" [-e]: no error if file no found (assume empty)\n"
"\n", progname);
}
