README.md 2.71 KB
Newer Older
Jørgen Lind's avatar
VDSCopy  
Jørgen Lind committed
1
2
## VDSCopy

Jørgen Lind's avatar
Jørgen Lind committed
3
A tool for copying a VDS between locations.
Jørgen Lind's avatar
VDSCopy  
Jørgen Lind committed
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

Usage:
```
VDSCopy [OPTION...] <source_url> <destination_url>
```

| Option                        | Decription |
|-------------------------------|------------|
|  -s, --source-connection      | Vendor specific connection string.
|  -d, --destination-connection | Vendor specific connection string.
| --compression-method          | Compression method. Supported compression methods are: None, RLE, Zip.
| --tolerance                   | This parameter specifies the compression tolerance when using the wavelet compression method. This value is the maximum deviation from the original data value when the data is converted to 8-bit using the value range. A value of 1 means the maximum allowable loss is the same as quantizing to 8-bit (but the average loss will be much much lower than quantizing to 8-bit). It is not a good idea to directly relate the tolerance to the quality of the compressed data, as the average loss will in general be an order of magnitude lower than the allowable loss.
| --json-output                 | Enable json output.
|  -h, --help                   | Print this help information
| --version                     | Print version information.

VDSCopy can use any url specifier. This makes it possible to copy from
- cloud to cloud (between different cloud vendors)
- cloud to local file
- local file to cloud

VDSCopy does not handle persistentIDs. It is therefore necessary to append any persistentID generated by SEGYImport to the urls. 

For more information about the ``[source|destination]_url`` and ``--[source|destination]-connection`` parameter please see:
http://osdu.pages.community.opengroup.org/platform/domain-data-mgmt-services/seismic/open-vds/connection.html
Some examples:

```
Jørgen Lind's avatar
Jørgen Lind committed
32
$ VDSCopy.exe s3://openvds-test/volve s3://openvds-test/volve_backup
Jørgen Lind's avatar
VDSCopy  
Jørgen Lind committed
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
```

This will copy the dataset in the s3 bucket openvds-test named volve to the same bucket with the name volve_backup.

```
$ VDSCopy.exe s3://openvds-test/volve local_file.vds
```
This will copy the dataset in the s3 bucket openvds-test named volve to a local file called local_file.vds.

```
$ VDSCopy.exe local_file.vds s3://openvds-test/volve
```
This will copy the vds in local_file.vds to the s3 bucket `openvds-test` and name the dataset volve.

```
$ VDSCopy.exe --compression-method Zip local_file.vds s3://openvds-test/volve
```
This will copy the vds in local_file.vds to the s3 bucket `openvds-test` and name the dataset volve.
But it will change the compression method used in the destination dataset to Zip.

*Note:* Currently VDSCopy will decompress the data. If a dataset with Wavelet lossy compression is copied with OpenVDS+, this will result in a recompression of the data with a lossy compression.