cd_warp

• purpose
• usage
• examples
• comments
• see also

Purpose:

This program will change the directory of the reslice target in the designated .warp file while leaving the actual file name unchanged. This utility is designed to allow you easily update .warp files in the event that you choose to move your original data to some new directory.

Usage:

cd_warp .warp-file new-directory [foreign-path-separator ]

where the following definitions apply:

.warp-file

the name of the .warp file

new-directory

the name of the directory that now contains the reslice file specified in the .warp file. (scan_warp can be used to identify the name of the reslice file specified in a given .warp file).

foreign-path-separator

the path separator used to separate directories from files on a foreign computer platform that uses a different separator from the local platform. For example, PC's use a backslash '\' whereas Unix systems use a forward slash '/' to separate directories and files. Thus when moving .warp files from a PC to a UNIX system, a foreign path separator of '\' must be specified. As an additional complication, backslashes are escape characters on UNIX systems, so a double backslash must be used '\\' so that the first backslash escapes the second.

Examples:

• The reslice file in mri.warp will now target the same file name as it did before, but the directory in which the file is presumed located is changed to /data/experiment1/
• This example is UNIX specific, since it uses UNIX style paths

Comments:

• The standard file is not updated. If you wish to use reslice_unwarp after moving files to a new directory, you will need to use the -a option with that program and explicitly name the new file and location on the command line with each use.
• As a safety measure, the name of the old reslice directory is stored in the .warp file comment line where it can be accessed using scan_warp. Note that a second application of this program will lose the original reslice directory completely.
• Move the reslice file before you update the .warp file if possible. This will allow the program to verify the dimensions and sizes of the reslice file and warn you if the file in the directory that you have designated has the same name but is not compatible.
• If compiled to allow automatic detection and application of byte swapping, AIR can use .warp files from bigendian or littleendian machines interchangeably so long as both platforms conform to the IEEE Standard for Binary Floating-Point Arithmetic (ISO/IEEE Std 754-1985) and represent relevant variables with the same total number of bytes. The foreign-path-separator optional argument further supports cross platform migration of .warp files

See also:

• cd_air
• mv_warp