annotate mayachemtool/mayachemtools/docs/scripts/txt/ModifyTextFilesFormat.txt @ 0:a4a2ad5a214e draft default tip

Uploaded
author deepakjadmin
date Thu, 05 Nov 2015 02:37:56 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
1 NAME
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
2 ModifyTextFilesFormat.pl - Change CSV Textfile(s) into TSV Textfile(s)
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
3 and vice versa
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
4
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
5 SYNOPSIS
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
6 ModifyTextFilesFormat.pl TextFile(s)...
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
7
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
8 ModifyTextFilesFormat.pl [-h, --help] [--indelim comma | semicolon]
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
9 [--outdelim comma | tab | semicolon] [-q, --quote yes | no] [-r, --root
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
10 rootname] [-w, --workingdir dirname] TextFile(s)...
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
11
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
12 DESCRIPTION
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
13 Interchange CSV and TSV *TextFile(s)* format. Mutiple file names are
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
14 separated by spaces. The valid file extensions are *.csv* and *.tsv* for
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
15 comma/semicolon and tab delimited text files respectively. All other
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
16 file names are ignored. All the text files in a current directory can be
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
17 specified by **.csv*, **.tsv*, or the current directory name. The
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
18 --indelim option determines the format of *TextFile(s)*. Any file which
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
19 doesn't correspond to the format indicated by --indelim option is
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
20 ignored.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
21
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
22 OPTIONS
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
23 -h, --help
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
24 Print this help message.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
25
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
26 --indelim *comma | semicolon*
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
27 Input delimiter for CSV *TextFile(s)*. Possible values: *comma or
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
28 semicolon*. Default value: *comma*. For TSV files, this option is
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
29 ignored and *tab* is used as a delimiter.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
30
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
31 -o, --overwrite
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
32 Overwrite existing files.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
33
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
34 --outdelim *comma | tab | semicolon*
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
35 Output text file delimiter. Possible values: *comma, tab, or
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
36 semicolon* Default value: *comma*.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
37
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
38 -q, --quote *yes | no*
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
39 Put quotes around column values in output text file. Possible
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
40 values: *yes or no*. Default value: *yes*.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
41
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
42 -r, --root *rootname*
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
43 New text file name is generated using the root: <Root>.<Ext>.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
44 Default new file name: <InitialTextFileName>FormatModified.<Ext>.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
45 The csv, and tsv <Ext> values are used for comma/semicolon, and tab
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
46 delimited text files respectively. This option is ignored for
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
47 multiple input files.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
48
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
49 -w, --workingdir *dirname*
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
50 Location of working directory. Default: current directory.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
51
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
52 EXAMPLES
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
53 To convert Sample*.csv into TSV files, type:
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
54
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
55 % ModifyTextFilesFormat.pl --outdelim tab -q no -o Sample*.csv
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
56
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
57 To convert Sample1.tsv into NewSample1.csv without any quotes around
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
58 column data values, type:
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
59
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
60 % ModifyTextFilesFormat.pl --outdelim comma - q no
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
61 -r NewSample1 -o Sample1.tsv
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
62
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
63 AUTHOR
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
64 Manish Sud <msud@san.rr.com>
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
65
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
66 SEE ALSO
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
67 ModifyNewLineChar.pl
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
68
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
69 COPYRIGHT
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
70 Copyright (C) 2015 Manish Sud. All rights reserved.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
71
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
72 This file is part of MayaChemTools.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
73
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
74 MayaChemTools is free software; you can redistribute it and/or modify it
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
75 under the terms of the GNU Lesser General Public License as published by
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
76 the Free Software Foundation; either version 3 of the License, or (at
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
77 your option) any later version.
a4a2ad5a214e Uploaded
deepakjadmin
parents:
diff changeset
78