Summary
EcDlDaParamConfig.rb provides users with the ability to view, add, and
remove rules for parameter inclusion and exclusion in the Data Access and Order
Manager forms.
Contributors
Contents
Description
Options
| Short | Long | Parameters | Description | Notes | |
|---|---|---|---|---|---|
| 1 | -m | --mode | MODE | The target mode (ex. DEV06) | |
| 2 | -b | --parameters | BAND_1...BAND_N | Space-separated list of parameters to configure. | Use the full path, starting with the object name. Acceptable delimiters include slashes and colons. (See notes for more details.) |
| 3 | -s | --services | SRV_1...SRV_N | Space-separated list of services to configure; will apply to all if excluded. | |
| 4 | -c | --collections | ESDT_1...ESDT_N | Space-separated list of collections to configure, will apply to all if excluded. | |
| 5 | -f | --formats | FORMAT_1...FORMAT_N | Space-separated list of formats to configure for the listed parameters(s). | Use database column 'name' to reference formats. Use 'NO_REFORMAT' for "No Reformatting". |
| 6 | -p | --projections | PROJECTION_1...PROJECTION_N | Space-separated list of projections to configure for the listed parameters(s). | Double quote (") names with spaces. Use database column 'name' to reference projections. |
| 7 | -v | --view | View all exclusions, filtered by given services, formats, parameters, or collections. | ||
| 8 | -i | --insert | Add the specified exclusions to the database. | ||
| 9 | -d | --delete | Remove the specified exclusions from the database. | ||
| 10 | -r | --require | Force band inclusion instead of exclusion. | Switches the column 'requireflag' from 'N' to 'Y'. | |
| 11 | -a | --compound | If activated, conditions will be AND-ed together instead of being OR-ed together, as is the default. | Switches the column 'compoundflag' from 'N' to 'Y'. | |
| 12 | -e | --examples | Show example invocations. | ||
| 13 | -z | --debug | Show the database query, without executing it. | ||
| 14 | -h | --help | Show this help text. |
Related Pages
Notes
Usage
To simply view the existing rules by collection, parameter, format, projection, or service, simply use --view and one more of the corresponding arguments. If no options are provided alongside --view, all rules will be shown.
EcDlDaParamConfig.rb --mode DEV06 --view
EcDlDaParamConfig.rb --mode DEV06 --view --parameters FileMainGroup/time --services HEG
EcDlDaParamConfig.rb --mode DEV06 --view --collections SPL3SMA.001 --parameters Radar_Data/altitude_std_dev --formats GeoTIFF --projections GEOGRAPHIC --services HEG
To add or remove a rule, use the --insert or --delete options, respectively. The two options are mutually exclusive, unless using the --debug option, whiich will simply print the SQL for the desired operation without performing it.
Arguments
Parameters must be listed using their full path, including objects, fields, and bands as applicable, using either a forward slash (/) or a colon (:) as delimiters. If an object name has a leading slash in the database, retain in the argument list.
Formats: use the string 'NO_REFORMAT' for instances of "No Reformatting"
The only required options for --insert and --delete operations are --services, --collections, and --parameters. For functionality, one of --formats or --projections is also needed. --view is valid alongside --insert and --delete but only one of --insert and --delete can be chosen in a single execution.
All of the options except --view, --insert, --delete, --require, and --compound require arguments.
Examples
Excluding format-parameter tuples
Invocation
EcDlDaParamConfig.rb
--mode DEV06
--parameters FileMainGroup/cell_column FileMainGroup/cell_row FileMainGroup/cell_lat FileMainGroup/cell_lon FileMainGroup/time GEO/latitude GEO/longitude
--formats NO_REFORMAT ASCII NetCDF-3
--services HEG
--view
Note that the following symbols reflect the empty string for No Reformatting: "^," | ",," | ",$"
Expected Results
collection | service | format | projection | parameter | required | compounded
--------------+---------+-----------------+------------+---------------------------+----------+------------
SPL4CMDL.001 | HEG | ,ASCII,NetCDF-3 | | GEO/latitude | Y,Y,Y | N,N,N
SPL4CMDL.001 | HEG | ,ASCII,NetCDF-3 | | GEO/longitude | Y,Y,Y | N,N,N
SPL4SMAU.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_column | Y,Y,Y | N,N,N
SPL4SMAU.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_lat | Y,Y,Y | N,N,N
SPL4SMAU.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_lon | Y,Y,Y | N,N,N
SPL4SMAU.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_row | Y,Y,Y | N,N,N
SPL4SMAU.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/time | Y,Y,Y | N,N,N
SPL4SMGP.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_column | Y,Y,Y | N,N,N
SPL4SMGP.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_lat | Y,Y,Y | N,N,N
SPL4SMGP.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_lon | Y,Y,Y | N,N,N
SPL4SMGP.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_row | Y,Y,Y | N,N,N
SPL4SMGP.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/time | Y,Y,Y | N,N,N
SPL4SMLM.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_column | Y,Y,Y | N,N,N
SPL4SMLM.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_lat | Y,Y,Y | N,N,N
SPL4SMLM.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_lon | Y,Y,Y | N,N,N
SPL4SMLM.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/cell_row | Y,Y,Y | N,N,N
SPL4SMLM.001 | HEG | ,ASCII,NetCDF-3 | | FileMainGroup/time | Y,Y,Y | N,N,N
(17 rows)
Even though no collections are specified, the exclusion only applies to collections containing the listed parameters.
Note that the following symbols reflect the empty string for No Reformatting: "^," | ",," | ",$"
Coming soon.
Excluding format-projection tuples for a collection
Invocation
EcDlDaParamConfig.rb
--mode DEV06
--formats NO_REFORMAT ASCII NetCDF-3
--projection GEOGRAPHIC
--services HEG
--collections
--view
Note that the following symbols reflect the empty string for No Reformatting: "^," | ",," | ",$"
Expected Results
Coming soon.
Overview
Content Tools