Common Error Messages

Common general error messages:

AIR_MEMORY_ALLOCATION_ERROR
The computer could not allocate enough memory to complete the task. It is possible that the command might succeed if reissued, particularly if other competing programs become inactive
AIR_STRING_NOT_DOUBLE_ERROR
Text that should have been a double precision number was not.
AIR_STRING_NOT_FLOAT_ERROR
Text that should have been a floating point precision number was not.
AIR_STRING_NOT_INT_ERROR
Text that should have been an integer was not.
AIR_STRING_NOT_LONG_ERROR
Text that should have been a long precision integer was not.
AIR_STRING_NOT_SCHAR_ERROR
Text that should have been a number from -128 to 127 was not.
AIR_STRING_NOT_SHORT_ERROR
Text that should have been a short integer (usually -32768 to 32767) was not.
AIR_STRING_NOT_UCHAR_ERROR
Text that should have been a number from 0 to 255 was not.
AIR_STRING_NOT_UINT_ERROR
Text that should have been a non-negative integer was not.
AIR_STRING_NOT_ULONG_ERROR
Text that should have been a long precision non-negative integer was not.
AIR_STRING_NOT_USHORT_ERROR
Text that should have been a non-negative short integer was not.
AIR_USER_INTERFACE_ERROR
This is a programming error. Whatever user interface has been devised to access the AIR library has failed to correctly screen invalid parameters.

General error messages related to input files

AIR_ACCESS_CODING_READ_ERROR
This error should only occur in the context of a programming error.
AIR_ACCESS_DENIED_READ_ERROR
The file system denies search permission for some component of the specified file path.
AIR_ACCESS_HOPS_READ_ERROR
The specified file requires hopping to multiple remote machines, and the file system does not support this.
AIR_ACCESS_LINKS_READ_ERROR
The specified file has too many symbolic links (it might be a symbolic link to a file that links back to the original symbolic link).
AIR_ACCESS_SIGNAL_READ_ERROR
The program 'caught a signal' while trying to access the file--retry?
AIR_ATYPICAL_FILE_READ_ERROR
The file is not a regular file or unsatisfied symbolic link, it might be a directory, a named pipe or some other special type of file but in any case, cannot be used for input
AIR_BAD_LINK_READ_ERROR
The file is a symbolic link that points to a non-existent file.
AIR_CANT_CLOSE_READ_ERROR
The program failed to close a file after reading it. You should retry the command
AIR_FILE_UNAVAILABLE_READ_ERROR
The attempt to read the file timed out before the file was accessed. There may be a file system problem if this error persists
AIR_FILE_UNMOUNTED_READ_ERROR
The file resides on a machine that is currently unmounted and hence unavailable
AIR_GROUP_CANT_READ_ERROR
Group members do not have permission to read this file. The owner of the file needs to change the file permission to grant group access in order for you to be able to read the file.
AIR_INVALID_PATH_READ_ERROR
The file's path is not valid (i.e., the directory in which the file suppossedly resides does not exist).
AIR_NAME_TOO_LONG_READ_ERROR
The file name or some component of the path name is too long. The relevant limitation is imposed by the file system, not by AIR
AIR_NO_FILE_READ_ERROR
The file does not exist (or at least cannot be opened)
AIR_NO_STAT_FILE_READ_ERROR
The file could not be opened for reading. This is the only information that can be returned on systems that do not support the non-ANSI C function stat().
AIR_OWNER_CANT_READ_ERROR
You own the file, but you have set the permissions of the file so that you cannot read it. On UNIX systems, the program chmod will allow you to change the permissions
AIR_STRUCT_READ_ERROR
A 'struct overflow' occurred while trying to read the file--retry?
AIR_UNSPECIFIED_FILE_READ_ERROR
An unknown proble occurred while trying to read the file.
AIR_UNUSUAL_FILE_READ_ERROR
An unknown problem, specific to your operating system, occurred while trying to read the file
AIR_WORLD_CANT_READ_ERROR
The file belongs to someone not in any of your groups. That person must give everyone read permission for the file in order for you to be able to read it

Error messages related to image input files

AIR_BAD_CODE_READ_ERROR
This error should only occur as the result of a programming error.
AIR_DECOMPRESS_READ_ERROR
In attempting to read a compressed file, the decompression command failed. This could be due to misconfiguration of AIR in the config.h or AIR.h file, a problem with the decompression program itself, or an incorrect format of the compressed file.
AIR_FSEEK_READ_ERROR
An error occurred when trying to find the location in the file to start reading the data.
AIR_HEADER_INIT_CODING_ERROR
This error should only occur as the result of a programming error.
AIR_INFO_BITS_ERROR
An image header indicates an unsupported number of bits per pixel (8 or 16 is supported).
AIR_INFO_DIM_ERROR
An image header indicates an x-, y- or z- dimension that is negative or zero. The program scanheader can be used to find the problem. If fixing the problem is merely a matter of changing a negative dimension to its absolute value, the program fixheader will repair it. Otherwise, you will need to remake the header using makeaheader.
AIR_INFO_HLENGTHFIELD_ERROR
An image header had a field that reports the header's length that is inaccurate. You can remake the header using makeaheader.
AIR_INFO_LIMIT_ERROR
A 16 bit file has internally inconsistent values for the global minima and maxima. This error should only occur when AIR is compiled in 8 bit mode. You can remake the header using makeaheader.
AIR_INFO_SIZE_ERROR
An image header indicates an x-, y- or z- voxel size that is negative or zero. The program scanheader can be used to find the problem. If fixing the problem is merely a matter of changing a negative voxel size to its absolute value, the program fixheader will repair it. Otherwise, you will need to remake the header using makeaheader.
AIR_PLANEWISE_DECOMPRESS_READ_ERROR
The program reads data on a plane-by-plane basis and hence cannot use compressed data.
AIR_READ_BINARYASNON_FILE_ERROR
An attempt was made to read a 1-bit 'binary' image file in a context that does not support such files.
AIR_READ_HEADER_FILE_ERROR
An image file header was not read correctly. The file format may be incorrect.
AIR_READ_IMAGE_FILE_ERROR
An image file was not read correctly. The file format may be incorrect.
AIR_READ_NONASBINARY_FILE_ERROR
An attempt was made to load an 8 or 16 bit file as a 1 bit 'binary' file in a format where this is not supported
AIR_READIMAGE_CODING_ERROR
This error should only occur as the result of a programming error

Error messages related to non-image input files

AIR_READ_AIR_FILE_ERROR
An input file that was supposed to be a .air file was the wrong length to be a .air file.
AIR_READ_ASCII_FILE_ERROR
An input ASCII file did not contain the expected information.
AIR_READ_INIT_FILE_ERROR
An input ASCII initialization file did not contain correctly formatted data. Each spatial transformation model has a different format.
AIR_READ_OLDWARP_FILE_ERROR
An input .air file appears to have been generated by an earlier (pre-AIR 5.0)version of AIR but cannot be read due to a coding error.
AIR_READ_PERSPWARP_FILE_ERROR
An input .air file contains perspective terms and is therefore unusable in this context.
AIR_READ_SCALING_FILE_ERROR
An input ASCII file that was supposed to contain scaling data does not contain correctly formatted data. The file should contain a single number.
AIR_READ_SUFFIX_FILE_ERROR
An input ASCII file with a designated suffix did not contain correctly formatted data. The file should contain a single number.
AIR_READ_UCF_FILE_ERROR
An ucf file did not contain valid data.
AIR_READ_VECTOR_FILE_ERROR
A vector file did not contain valid data.
AIR_READ_WARP_FILE_ERROR
A warp file did not contain valid data.
AIR_WARP_NOT_FIRST_ORDER_ERROR
You have specified a .warp file where a .air file is required and the designated .warp file contains terms higher than first order and therefore cannot be converted

General error messages related to output files

AIR_ACCESS_CODING_WRITE_ERROR
This error should only occur in the context of a programming error.
AIR_ACCESS_DENIED_WRITE_ERROR
The file system denies search permission for one of the output directories or subdirectories.
AIR_ACCESS_HOPS_WRITE_ERROR
The specified output file requires hopping to multiple remote machines, and the file system does not support this.
AIR_ACCESS_LINKS_WRITE_ERROR
The specified output file directory has too many symbolic links (it might involve a symbolic link to a directory that links back to the original symbolic link).
AIR_ACCESS_SIGNAL_WRITE_ERROR
The program 'caught a signal' while trying to write the file--retry?
AIR_ATYPICAL_FILE_WRITE_ERROR
A file with the same name as the output file already exists and is not a regular file or unsatisfied symbolic link, it might be a directory, a named pipe or some other special type of file but in any case, cannot be used for output
AIR_CANT_CLOSE_WRITE_ERROR
The program failed to close a file after writing it. The file should not be used since it may not contain reliable data.
AIR_FILE_UNAVAILABLE_WRITE_ERROR
The attempt to write the file timed out before the file was accessed. There may be a file system problem if this error persists.
AIR_FILE_UNMOUNTED_WRITE_ERROR
The output file directory resides on a machine that is currently unmounted and hence unavailable
AIR_GROUP_CANT_WRITE_ERROR
Group members do not have permission to write to this file or directory. The owner of the file needs to change the file permission to grant group access in order for you to be able to write the file.
AIR_INVALID_PATH_WRITE_ERROR
The output file's path is not valid (i.e., the directory in which the file suppossedly resides does not exist).
AIR_NAME_TOO_LONG_WRITE_ERROR
The output file name or some component of the path name is too long. The relevant limitation is imposed by the file system, not by AIR
AIR_NO_DIRECTORY_WRITE_ERROR
The output directory does not exist (or at least cannot be accessed)
AIR_NO_PERMISSION_WRITE_ERROR
A file with the same name as the output file already exists and overwrite permission has not been granted.
AIR_OWNER_CANT_WRITE_ERROR
You own the output file or its directory, but you have set the permissions of the file or directory so that you cannot write to it. On UNIX systems, the program chmod will allow you to change the permissions
AIR_STRUCT_WRITE_ERROR
A 'struct overflow' occurred while trying to write the file--retry?
AIR_UNSPECIFIED_FILE_WRITE_ERROR
An unknown proble occurred while trying to write the file.
AIR_UNUSUAL_FILE_WRITE_ERROR
An unknown problem, specific to your operating system, occurred while trying to write the file
AIR_WORLD_CANT_WRITE_ERROR
The output file belongs to someone not in any of your groups. That person must give everyone write permission for the file in order for you to be able to write it

Error messages related to image output files

AIR_FSEEK_WRITE_ERROR
The appropriate location in an output file could not be located.
AIR_WRITE_BAD_DIM_ERROR
A programming error led to an attempt to save a file with a zero or negative dimension
AIR_WRITE_BADBITS_CODING_ERROR
A programming error led to an attempt to save a file with an unsupported number of bits per pixel
AIR_WRITE_HEADER_FILE_ERROR
An image header file was not written correctly and therefore contains invalid data.
AIR_WRITE_IMAGE_FILE_ERROR
An image file was not written correctly and therefore contains invalid data.
AIR_WRITE_NONASBINARY_CODING_ERROR
A programming error led to an attempt to save a regular file as a 1-bit 'binary' file

Error messages related to non-image output files

AIR_WRITE_AIR_FILE_ERROR
An output .air file was not written correctly and contains invalid data.
AIR_WRITE_ASCII_FILE_ERROR
An output ASCII file was not written correctly and contains invalid data.
AIR_WRITE_INIT_FILE_ERROR
An output initialization (termination) file was not written correctly and contains invalid data.
AIR_WRITE_SCALING_FILE_ERROR
An output ASCII file for scaling data was not written correctly and contains invalid data.
AIR_WRITE_SUFFIX_FILE_ERROR
An output ASCII file with a designated suffix was not written correctly and contains invalid data.
AIR_WRITE_UCF_FILE_ERROR
An output ucf file was not written correctly and contains invalid data.
AIR_WRITE_WARP_FILE_ERROR
An output warp file was not written correctly and contains invalid data.
Modified: February 12, 2002

© 2001-2002 Roger P. Woods, M.D.(rwoods@ucla.edu)