VDSInfo

A tool for extracting info from a VDS.

Usage:

VDSInfo [OPTION...] <url>

Option

Decription

–connection <string>

Connection string for the VDS

–persistentID <ID>

A globally unique ID for the VDS, usually an 8-digit hexadecimal number.

–axis

Print axis descriptors.

–channels

Print channel descriptors.

–layout

Print layout.

-g, –dimension-groups

Print a list of dimension groups.

–compression-info

Print compression-info.

–metadata-all

Print all metadata.

–metadatakeys

Print metadata keys.

–metadata-name <string>

Print metadata matching name.

–metadata-category <string>

Print metadata matching category.

–metadata-firstblob

Print first blob found.

–metadata-autodecode

Autodetect EBCDIC and decode to ASCII for blobs.

–metadata-force-width <arg>

Force output width.

–url <string>

Url for the VDS. This is preserved because of legacy purposes. Use the positional argument instead (ie. no -).

-h, –help

Print this help information

VDSInfo prints out the result of the query in json, and it will try and give the shortest json for the specific query by eliminating redundant json parent structures.

For more information about the url and --connection parameter please see: https://osdu.pages.opengroup.org/platform/domain-data-mgmt-services/seismic/open-vds/connection.html Some examples:

$ VDSInfo.exe s3://openvds-test --persistentID 7068247E9CA6EA05 --channels --axis --layout

This will print out a json object with the following children

  • axisDescriptors (an array)

  • channelDescriptors (an array)

  • layoutDescriptor (an object)

while

$ VDSInfo.exe s3://openvds-test --persistentID 7068247E9CA6EA05 --channels

will print an array with channel descriptors

$ VDSInfo.exe s3://openvds-test --persistentID 7068247E9CA6EA05 --metadatakeys

will print an array with the metadata keys. Together with other queries it will be in the metaKeysInfo member of the root object;

Its also possible to add the perssitenID into the url:

$ VDSInfo.exe s3://openvds-test/7068247E9CA6EA05 --metadatakeys

Metadata can be queried with the --metadata-category and --metadata-name predicates. All metadata matching category and name are put in a json structure. BLOBs are not added to this json structure. Missing category or name predicate is acting as a wildcard.

If --metadata-firstblob is specified or that all parameters end up only matching BLOB meta properties, then the first matched property will print.

$ VDSInfo.exe s3://openvds-test/7068247E9CA6EA05 --metadata-name TextHeader

will write the first TextHeader metadata property in the VDS. If this is a blob property it will be written directly to stdout.

The text header property can sometimes be encoded in EBCDIC enconding. Add the -e parameter to autodetect EBCDIC and decode to ASCII.

To force a width for BLOB printing use the -w parameter.

$ VDSInfo.exe s3://openvds-test/7068247E9CA6EA05 --metadata-name TextHeader -e -w 80