README.rst

branch
development
changeset 54
5a2e8efdaae9
parent 51
a4ca2b6d67f5
child 63
a41f71f80c1d
equal deleted inserted replaced
53:934a5e0a05c9 54:5a2e8efdaae9
6 6
7 * Upload a file to the SCC for processing 7 * Upload a file to the SCC for processing
8 * Download the processed files and graphs 8 * Download the processed files and graphs
9 * Delete an existing measurement from the SCC (with appropriate privileges) 9 * Delete an existing measurement from the SCC (with appropriate privileges)
10 10
11 The main functions are implemented in a class (SCC) that you can also import
12 and use in your custom scripts.
13 11
14 The script does not provide any feedback if a file upload fails. Before using 12 The script provides limited feedback when a file upload fails. Before using
15 the script, you will need to upload some files manually and be confident that 13 the script, you will need to upload some files manually and be confident that
16 your SCC file format and processing settings are correct. 14 your SCC file format and processing settings are correct.
17 15
18 Please note that this is not part of the "official" SCC tools. 16 Please note that this is not part of the "official" SCC tools.
17
18 In principle, the main functions are implemented in a class (SCC) that you can also import
19 and use in your custom scripts. However, error handling has to be improved in this case. If you are interested
20 in such use, please contact me at ioannis@inoe.ro.
19 21
20 Any suggestions for improvements and new features are more than welcome. 22 Any suggestions for improvements and new features are more than welcome.
21 23
22 Installation 24 Installation
23 ------------ 25 ------------
70 The two command above assume that you have placed your setting file in the default location. You can specify a 72 The two command above assume that you have placed your setting file in the default location. You can specify a
71 custom location using the -c flag:: 73 custom location using the -c flag::
72 74
73 scc_access -c ./path/to/settings.yaml upload-file 20110101po01.nc 125 75 scc_access -c ./path/to/settings.yaml upload-file 20110101po01.nc 125
74 76
75 By default, the SCC will reject an uploaded file, if the specified measurement id already exists on the server. You 77 By default, the SCC will reject an uploaded file if the specified measurement id already exists on the server. You
76 can instruct the script to delete any existing measurement before uploading using the `--force_upload` flag:: 78 can instruct the script to delete any existing measurement before uploading using the `--force_upload` flag::
77 79
78 scc_access upload-file 20110101po01.nc 125 -p --force_upload 80 scc_access upload-file 20110101po01.nc 125 -p --force_upload
81
82 When uploading a measurement you can require that the processing is delayed by a specified number of hours. This
83 can be used to assure that your files are processed using model input data, that typically have a delay of more than
84 24 hours. You can specify the delay (in hours) using the --delay option::
85
86 scc_access upload-file 20110101po01.nc 125 --delay 48
87
88 .. note::
89 When specifying a delay, the script will not wait to download the output files.
79 90
80 If you want to delete an existing measurement id from the database use the `delete` 91 If you want to delete an existing measurement id from the database use the `delete`
81 command and the measurement id:: 92 command and the measurement id::
82 93
83 scc_access delete 20110101po01 94 scc_access delete 20110101po01
132 filename Measurement file name or path. 143 filename Measurement file name or path.
133 system Processing system id. 144 system Processing system id.
134 145
135 optional arguments: 146 optional arguments:
136 -h, --help show this help message and exit 147 -h, --help show this help message and exit
148 --delay DELAY Delay processing by the specified number of hours (0 to 96).
137 -p, --process Wait for the processing results. 149 -p, --process Wait for the processing results.
138 --force_upload If measurement ID exists on SCC, delete before 150 --force_upload If measurement ID exists on SCC, delete before
139 uploading. 151 uploading.
140 --radiosounding RADIOSOUNDING 152 --radiosounding RADIOSOUNDING
141 Radiosounding file name or path 153 Radiosounding file name or path

mercurial