nv_dataset: The nv_dataset command...
nv_dataset dir dirName: Sets current directory to directory dirName.
nv_dataset create fileName dim1Size dim2Size ...: Create a dataset named 'fileName'. The number of dimensions is determined by the number of dim?Size arguments. The size of each dimension should be specified with the dimSize parameters. Examples: "nv_dataset create noesy.nv 2048 1024" "nv_dataset create hnco.nv 512 128 64"
nv_dataset flush datasetName: Flush the memory buffers for the dataset to disk. This is only relevant for datasets that have been opened with write access.
nv_dataset wrheader datasetName: Writes the dataset header to disk. Do this after changing reference information. This is only operable for datasets that have been opened with write access.
nv_dataset open ? -wr ? fileName: Opens a compatible dataset named fileName. The fileName should specify the complete path to the file. However, further references to the file within NMRView should use only the filename and not any directory prefix. The file is opened read only unless the optional flag "-wr" is included, in which case the file will be opened for read and write access. If the 'fileName' is not specified the command returns a list of the currently opened files.
nv_dataset close datasetName: Closes a dataset 'named datasetName'.
nv_dataset get datasetName ? -d1 dimRange ? -d2 dimRange ? ... ? -obj vecName ?: Extracts the datapoints from the specified region of the spectrum. The data is read into a vector specified by 'vecName'. If the 'vecName' is not specified it is assumed to be "work". If the limits for a specified dimension are not included, then the range of all points for that dimension are extracted. If the range specifiers are followed by a p (for example, 113p) the range is specified in data points, otherwise it is assummed to be in ppm. If only one of the two values for a given range is specified, then the two are assummed to be equal. The data is extracted from the dataset specified by 'datasetName' Examples: "nv_dataset get noesy -d1 0.3 1.2 -d2 7.0", "nv_dataset get noesy -d1 80p -d2 7.0 8.0", "nv_dataset get noesy -d1 1.2"
nv_dataset analyze datasetName ? -d1 dimRange ? -d2 dimRange ? ... ? -obj vecName ?: Analyzes the data in the specified region of the spectrum. If the limits for a specified dimension are not included, then the range of all points for that dimension are extracted. If the range specifiers are followed by a p (for example, 113p) the range is specified in data points, otherwise it is assummed to be in ppm. If only one of the two values for a given range is specified, then the two are assummed to be equal. The data is analyzed in the dataset specified by 'datasetName' The results are returned in two forms. First, a list of values seperated by descriptors is returned: "center 47 jitter 53 max 37 ..." Second, each value is also written to a variable Nv_Value(name). For example, the center intensity will be in Nv_Value(center), the maximum intensity will be in Nv_Value(max) etc. Examples: "nv_dataset analyze noesy -d1 0.3 1.2 -d2 7.0", "nv_dataset analyze noesy -d1 80p -d2 7.0 8.0", "nv_dataset analyze noesy -d1 1.2" volume: Return the sum of the points in the region. max: Return the maximum value from the region. min: Return the minimum value from the region. extreme:Return the most extreme (maximum or minimum) value from the cursor region. mean: Return the average value in the cursor region. center: Return the value at the center of the cursor region. jitter: Return the largest value (of the same sign as center point) within a certain tolerance (+/- 25% of the region width) of the center of the cursor region. sdev: Return the standard deviation of the values in the curror region.
nv_dataset put datasetName ? -d1 dimRange ? -d2 dimRange ? ... ? -obj vecName ?: The data is written from a vector specified by 'vecName'. If the 'vecName' is not specified it is assumed to be "work". Writes the datapoints to the specified region of the spectrum. If the limits for a specified dimension are not included, then the range of all points for that dimension are extracted. If the range specifiers are followed by a p (for example, 113p) the range is specified in data points, otherwise it is assummed to be in ppm. If only one of the two values for a given range is specified, then the two are assummed to be equal. The data is extracted from the dataset specified by 'datasetName' Examples: "nv_dataset get noesy -d1 0.3 1.2 -d2 7.0", "nv_dataset get noesy -d1 80p -d2 7.0 8.0",
nv_dataset scanstart datasetName dimNumber vectorName: Sets up various internal parameters for an optimized scan through the dataset using the "nv_dataset scanget" and "nv_dataset scanput" commands. Specify the dataset with the 'datasetName' parameter. The 'dimNumber' parameter specifys the axis, parallel to which, the data will be read to or written from. The 'vectorName' argument specifies the name of the vector in to which data will be read by the "nv_dataset scanget" command, or written from with the "nv_dataset scanput" command. Example: "nv_dataset scanstart hnco.nv 2 work"
nv_dataset scanget: Each time this command is called a vector will be read from a dataset and stored into a vector. The dataset, dataset dimension and vector name must first be setup with the "nv_dataset scanstart" command. The vectors are not necessarily read in sequential order from the matrix. Instead, they are read in an optimal order as defined by the dataset layout. If data is succesfully read, the command will return "1", if the end of the matrix is reached the command will return "0". Thus the command "while [nv_dataset scanget]" will scan the entire matrix.
nv_dataset scanput: This command is analogous to the "nv_dataset scanget" command, but writes data from a vector to the matrix, rather than reading it.
nv_dataset label nv_datasetName dim ? arg ?: Returns the labelName for dimension dim of nv_dataset nv_datasetName. If the optional argument is specified the label is changed to the new value.
nv_dataset ref nv_datasetName dim ? arg ?: Returns the chemical shift at the reference point for dimension dim of nv_dataset nv_datasetName. If the optional argument is specified the chemical shift is changed to the new value. For example, nv_dataset ref hncoca.mat 2 182.3, changes the chemical shift along dimension 2 of the nv_dataset named hncoca.mat to 182.3.
nv_dataset refpt nv_datasetName dim ? arg ?: Returns the datapoint at which the reference chemical shift is specified for dimension dim of nv_dataset nv_datasetName. If the optional argument is specified the data point used for reference is changed to the new value. For example, nv_dataset refpt hncoca.mat 3 17, changes the sweepwidth along dimension 3 of the nv_dataset named hncoca.mat to 17.
nv_dataset size datasetName dimNum: Returns the number of points along the dimension of 'datasetName' specified with the 'dimNum' argument.
nv_dataset sf nv_datasetName dim ? arg ?: Returns the spectrometer frequency for dimension dim of nv_dataset nv_datasetName. If the optional argument is specified the spectrometer frequency is changed to the new value. For example, nv_dataset sf hncoca.mat 1 600.5, changes the spectrometer frequency corresponding to dimension 1 of the nv_dataset named hncoca.mat to 600.5.
nv_dataset pt nv_datasetName dimNum ppmVal: Returns the dataset point closest to the chemical shift specified by 'ppmVal' along the dimension specified by 'dimNum'. Example: "set pt [nv_dataset pt noesy.nv 1 8.3]"
nv_dataset ndim datasetName: Returns the number of dimensions of the dataset specified by 'datasetName'.
nv_dataset sw nv_datasetName dim ? arg ?: Returns the sweepwidth set for dimension dim of nv_dataset nv_datasetName. If the optional argument is specified the sweepwidth is changed to the new value. For example, nv_dataset sw hncoca.mat 3 1800, changes the sweepwidth along dimension 3 of the nv_dataset named hncoca.mat to 1800.
nv_dataset rdpar datasetName: Reads a parameter file associated with the dataset specified with 'datasetName'.
nv_dataset wrpar datasetName: Writes a parameter file associated with the dataset specified with 'datasetName'.