void usage()
{
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," txt2las (version %s) usage:\n", LAS_GetVersion());
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr,"\n");
fprintf(stderr,"Parse a text file with a given format:\n");
fprintf(stderr," txt2las -parse tsxyz lidar.txt\n");
fprintf(stderr,"\n");
fprintf(stderr,"Set the scale:\n");
fprintf(stderr," txt2las --parse xyz --scale 0.02 -i lidar.txt -o lidar.laz\n");
fprintf(stderr,"\n");
fprintf(stderr,"Set the xyz scale:\n");
fprintf(stderr," txt2las --parse xsysz --verbose --xyz_scale 0.02 0.02 0.01 lidar.txt\n");
fprintf(stderr,"\n");
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," The '--parse txyz' flag specifies how to format each\n");
fprintf(stderr," each line of the ASCII file. For example, 'txyzia'\n");
fprintf(stderr," means that the first number of each line should be the\n");
fprintf(stderr," gpstime, the next three numbers should be the x, y, and\n");
fprintf(stderr," z coordinate, the next number should be the intensity\n");
fprintf(stderr," and the next number should be the scan angle.\n");
fprintf(stderr," The supported entries are:\n");
fprintf(stderr," a - scan angle\n");
fprintf(stderr," i - intensity\n");
fprintf(stderr," n - number of returns for given pulse\n");
fprintf(stderr," r - number of this return\n");
fprintf(stderr," c - classification\n");
fprintf(stderr," u - user data (does not currently work)\n");
fprintf(stderr," p - point source ID\n");
fprintf(stderr," e - edge of flight line\n");
fprintf(stderr," d - direction of scan flag\n");
fprintf(stderr," R - red channel of RGB color\n");
fprintf(stderr," G - green channel of RGB color\n");
fprintf(stderr," B - blue channel of RGB color\n\n");
fprintf(stderr,"\n----------------------------------------------------------\n");
fprintf(stderr," The '-scale 0.02' flag specifies the quantization. The\n");
fprintf(stderr," default value of 0.01 means that the smallest increment\n");
fprintf(stderr," two between coordinates is 0.01. If measurements are in\n");
fprintf(stderr," meters this corresponds to centimeter accuracy, which is\n");
fprintf(stderr," commonly considered sufficient for LIDAR data.\n");
fprintf(stderr,"\n----------------------------------------------------------\n");
fprintf(stderr," Other parameters such as '--xyz_offset 500000 2000000 0'\n");
fprintf(stderr," or '-xyz_scale 0.02 0.02 0.01' or '-file_creation 67 2003'\n");
fprintf(stderr," or '-system_identifier \"Airborne One Leica 50,000 Hz\"'\n");
fprintf(stderr," or '-generating_software \"TerraScan\"' are available too.\n");
fprintf(stderr, "For more information, see the full documentation for txt2las at:\n"
" http://liblas.org/browser/trunk/doc/txt2las.txt\n");
fprintf(stderr,"----------------------------------------------------------\n");
}
void usage()
{
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," las2txt (version %s) usage:\n", LAS_GetVersion());
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a las file to text on stdout:\n");
fprintf(stderr," las2txt lidar.las\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert using stdin and stdout:\n");
fprintf(stderr," las2txt --stdin --stdout < lidar.las > lidar.txt\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert to text with a specified format :\n");
fprintf(stderr," las2txt --parse xyziar lidar.las lidar.txt\n");
fprintf(stderr,"\n");
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," The '--parse txyz' flag specifies how to format each\n");
fprintf(stderr," each line of the ASCII file. For example, 'txyzia'\n");
fprintf(stderr," means that the first number of each line should be the\n");
fprintf(stderr," gpstime, the next three numbers should be the x, y, and\n");
fprintf(stderr," z coordinate, the next number should be the intensity\n");
fprintf(stderr," and the next number should be the scan angle.\n");
fprintf(stderr," The supported entries are:\n");
fprintf(stderr," a - scan angle\n");
fprintf(stderr," i - intensity\n");
fprintf(stderr," n - number of returns for given pulse\n");
fprintf(stderr," r - number of this return\n");
fprintf(stderr," c - classification\n");
fprintf(stderr," u - user data (does not currently work)\n");
fprintf(stderr," p - point source ID\n");
fprintf(stderr," e - edge of flight line\n");
fprintf(stderr," d - direction of scan flag\n");
fprintf(stderr," R - red channel of RGB color\n");
fprintf(stderr," G - green channel of RGB color\n");
fprintf(stderr," B - blue channel of RGB color\n");
fprintf(stderr," M - vertex index number\n\n");
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," The '--sep space' flag specifies what separator to use. The\n");
fprintf(stderr," default is a space but 'tab', 'komma', 'colon', 'hyphen',\n");
fprintf(stderr," 'dot', or 'semicolon' are other possibilities.\n\n");
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," The '--header pound' flag results in the header information\n");
fprintf(stderr," being printed at the beginning of the ASCII file in form of\n");
fprintf(stderr," a comment that starts with the special character '#'. Also\n");
fprintf(stderr," possible are 'percent', 'dollar', 'semicolon', 'komma',\n");
fprintf(stderr," 'star', 'colon', or 'semicolon' as that special character.\n");
fprintf(stderr, "\nFor more information, see the full documentation for las2txt at:\n"
" http://liblas.org/browser/trunk/doc/las2txt.txt\n");
fprintf(stderr,"----------------------------------------------------------\n");
}
void usage()
{
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," las2col (version %s) usage:\n", LAS_GetVersion());
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a las file into columnar format (binary), outputs <input_file>_col_<entry_name>.dat (for all entries):\n");
fprintf(stderr," las2col -i <input_file>.las\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a las file into columnar format (binary), outputs <ouput_name>_col_<entry_name>.dat:\n");
fprintf(stderr," las2col -i <input_file>.las <output_dir_path/prefix>\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a las file into columnar format (binary), outputs <input_file>_col_<entry_name>.dat (only for xyziar entries) :\n");
fprintf(stderr," las2col --parse xyziar -i <input_file>.las\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a list of las files into columnar format (binary), outputs <input_file>_col_<entry_name>.dat (only for xyziar entries) :\n");
fprintf(stderr," las2col -f <file_with_the_list_las_files> --parse xyziar <input_file>.las\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a list of las files into columnar format (binary), outputs <input_file>_col_<entry_name>.dat (only for xyziar entries) :\n");
fprintf(stderr," las2col -i <las_file_1> -i <las_file_2> --parse xyziar <input_file>.las\n");
fprintf(stderr,"\n");
fprintf(stderr,"Convert a list of las files into columnar format (binary) using <num_read_threads> threads (default is 16), outputs <input_file>_col_<entry_name>.dat (only for xyziar entries) :\n");
fprintf(stderr," las2col --num_read_threads <number_of_threads> -i <las_file_1> -i <las_file_2> --parse xyziar <input_file>.las\n");
fprintf(stderr,"\n");
fprintf(stderr,"----------------------------------------------------------\n");
fprintf(stderr," The '--parse txyz' flag specifies each entries of the LAS\n");
fprintf(stderr," will be extracted. For example, 'txyzia'\n");
fprintf(stderr," means that the first number of each line should be the\n");
fprintf(stderr," gpstime, the next three numbers should be the x, y, and\n");
fprintf(stderr," z coordinate, the next number should be the intensity\n");
fprintf(stderr," and the next number should be the scan angle.\n");
fprintf(stderr," The supported entries are:\n");
fprintf(stderr," t - gpstime\n");
fprintf(stderr," x - x coordinate as a double\n");
fprintf(stderr," y - y coordinate as a double\n");
fprintf(stderr," z - z coordinate as a double\n");
fprintf(stderr," X - x coordinate as a decimal)\n");
fprintf(stderr," Y - y coordinate as a decimal)\n");
fprintf(stderr," Z - z coordinate as a decimal)\n");
fprintf(stderr," a - scan angle\n");
fprintf(stderr," i - intensity\n");
fprintf(stderr," n - number of returns for given pulse\n");
fprintf(stderr," r - number of this return\n");
fprintf(stderr," c - classification number\n");
fprintf(stderr," C - classification name\n");
fprintf(stderr," u - user data (does not currently work)\n");
fprintf(stderr," p - point source ID\n");
fprintf(stderr," e - edge of flight line\n");
fprintf(stderr," d - direction of scan flag\n");
fprintf(stderr," R - red channel of RGB color\n");
fprintf(stderr," G - green channel of RGB color\n");
fprintf(stderr," B - blue channel of RGB color\n");
fprintf(stderr," M - vertex index number\n\n");
fprintf(stderr," k - Morton 2D code using X and Y (no scale and no offset)\n\n");
fprintf(stderr," The '--moffset 8600000,40000000' flag specifies an global offset in X and Y \n");
fprintf(stderr," to be used when computing the Morton 2D code. Values must be unscaled \n");
fprintf(stderr," The '--check 0.01,0.01' flag checks suitability to compute Morton 2D codes \n");
fprintf(stderr," It checks specified scale matches the one in input file. \n");
fprintf(stderr," If moffset is provided it also checks that obtained Morton 2D codes \n");
fprintf(stderr," will be consistent, i.e. global X,Y within [0,2^31] \n\n");
fprintf(stderr, "\nFor more information, see the full documentation for las2col at:\n"
" http://liblas.org/browser/trunk/doc/las2col.txt\n");
fprintf(stderr,"----------------------------------------------------------\n");
}
