NCL Home > Documentation > Graphics > Resources

CoordArrTable (ct) Resources

ctCopyTables
This resource is used to determine if the CoordArrTable object should make its own copy of the ctXTable and ctYTable data. If this resource is False, it is important for the programmer to keep the data around without modifying it.

Default: True

ctXElementSize
This resource is used to indicate the size of each element of each vector in the ctXTable resource. If the ctXTable resource is set, and this one is not, then the CoordArrTable object will use the ctXTableType resource to try to determine the size of each element; therefore this resource is usually not necessary.

Default: <dynamic>
Determined from ctXTableType if possible.

ctXMaxV
This resource is used to tell the CoordArrTable object the maximum value contained in the ctXTable resource. If it is not specified, the CoordArrTable object will compute it. This resource has a dynamic type so that elements of any type can be set to it.

Default: <dynamic>
The value will be computed if it is not set.

ctXMinV
This resource is used to tell the CoordArrTable object the minimum value contained in the ctXTable resource. If it is not specified, the CoordArrTable object will compute it. This resource has a dynamic type so that elements of any type can be set to it.

Default: <dynamic>
The value will be computed if it is not set.

ctXMissingV
This resource indicates a missing value for elements in the ctXTable resource. When the HLU library is parsing the data in the ctXTable elements, it will treat any element with this value as missing data. This resource has a dynamic type so that elements of any type can be set to it. It is important to realize that the elements in ctXTable will be converted to float, and the contents of this resource will be converted to float, before the elements are compared with the value of this resource.

Default: None

ctXTable
This resource specifies the X values of the X/Y coordinate data. It is an array of X vectors. Each vector is actually a single-dimension array of type ctXTableType. The length of each vector array is determined by the corresponding element of the ctXTableLengths resource. If this resource is set, then the corresponding ctXTableLengths resource must also be set. If the ctXTable resource is not set, then all of the Y values set with the ctYTable resource will be paired with their integer array index. For example,
(1, (ytable[0])[0])
(2, (ytable[0])[1])
(ytable_lengths[0], (ytable[0])[ytable_lengths[0]-1])
If one of the vectors in the ctXTable resource is NULL, then it is interpreted to contain an integer array index vector as well, with the ctXTableLengths resource indicating the length of the vector.

If the ctXTable resource is not set, then the ctYTable resource must be set.

Default: NULL

ctXTableLengths
This resource is a one-dimensional integer array. Each element of the array indicates the length of the corresponding vector in the ctXTable resource. This resource must be set if the ctXTable resource is set.

Default: NULL

ctXTableType
This resource is used to indicate the type of each element of each vector in the ctXTable resource. It is a string value of the type's name. For example, "Integer". There are symbols provided to the C interface for all the available types. "Integer" would be set with NhlTInteger.

Default: NULL
This resource must be set if the ctXTable resource is set.

ctYElementSize
This resource is used to indicate the size of each element of each vector in the ctYTable resource. If the ctYTable resource is set, and this one is not, then the CoordArrTable object will use the ctYTableType resource to try to determine the size of each element; therefore this resource is not usually necessary.

Default: <dynamic>
Determined from ctYTableType if possible.

ctYMaxV
This resource is used to tell the CoordArrTable object the maximum value contained in the ctYTable resource. If it is not specified, the CoordArrTable object will compute it. This resource has a dynamic type so that elements of any type can be set to it.

Default: <dynamic>
The value will be computed if it is not set.

ctYMinV
This resource is used to tell the CoordArrTable object the minimum value contained in the ctYTable resource. If it is not specified, the CoordArrTable object will compute it. This resource has a dynamic type so that elements of any type can be set to it.

Default: <dynamic>
The value will be computed if it is not set.

ctYMissingV
This resource indicates a missing value for elements in the ctYTable resource. When the HLU library is parsing the data in the ctYTable elements, it will treat any element with this value as missing data. This resource has a dynamic type so that elements of any type can be set to it. It is important to realize that the elements in ctYTable will be converted to float, and the contents of this resource will be converted to float, before the elements are compared with the value of this resource.

Default: None

ctYTable
This resource specifies the Y values of the X/Y coordinate data. It is an array of Y vectors. Each vector is actually a single-dimension array of type ctYTableType. The length of each vector array is determined by the corresponding element of the ctYTableLengths resource. If this resource is set, then the corresponding ctYTableLengths resource must also be set. If the ctYTable resource is not set, then all of the X values set with the ctXTable resource will be paired with their integer array index. For example,
((xtable[0])[0], 1)
((xtable[0])[1]), 2)
((xtable[0])[xtable_lengths[0]-1],xtable_lengths[0])
If one of the vectors in the ctYTable resource is NULL, then it is interpreted to contain an integer array index vector as well, with the ctYTableLengths resource indicating the length of the vector.

If the ctYTable resource is not set, then the ctXTable resource must be set.

Default: NULL

ctYTableLengths
This resource is a one-dimensional integer array. Each element of the array indicates the length of the corresponding vector in the ctYTable resource. This resource must be set if the ctYTable resource is set.

Default: NULL

ctYTableType
This resource is used to indicate the type of each element of each vector in the ctYTable resource. It is a string value of the type's name. For example, "Integer". There are symbols provided to the C interface for all the available types. "Integer" would be set with NhlTInteger.

Default: NULL
This resource must be set if the ctYTable resource is set.