|
|
GCE Data Toolbox Functions
version 2.95, 25-Jul-2008
(c)2002-2008 Wade M. Sheldon and the Georgia Coastal Ecosystems LTER Project
| GUI Applications and Utilities |
| ui_aboutgce |
GCE Data Toolbox startup splash screen with links to the
structure editor and documentation |
| ui_aggrdatetime |
GUI dialog for calculating statistics for selected columns after grouping records within specified date/time intervals and by values in one or more data columns |
| ui_aggrmovingdate |
GCE Data Toolbox aggregated statistics along a moving date/time window dialog |
| ui_aggrstats |
GCE Data Toolbox aggregated statistics dialog |
| ui_axislimits |
Axis limits dialog box called by 'plotbuttons' |
| ui_bindata |
GUI dialog for calculating statistics for selected columns
after binning data by values in one column and optionally grouping
records by values in one or more data columns |
| ui_calculator |
Dialog for adding calculated columns to a GCE Data
Structure by evaluating a user-specified MATLAB expression |
| ui_copyflags |
GUI dialog for copying composite flags from one or more columns and adding them to or replacing the existing flag arrays of one or more other columns (used to propagate flags to dependent/calculated columns) |
| ui_clearflags |
GUI dialog for selectively deleting data values or data rows based on QA/QC flag assignments. Subsets of data columns and flag definitions can be selected from lists of all available columns and definitions. The functions 'nullflags' or 'cullflags' are used to clear the affected values or rows, resp. |
| ui_dataflag |
Dialog for manually editing QA/QC flags for selected
columns in a GCE Data Structure. Existing flags are displayed alongside
the corresponding data column, and edited flag values are copied to the
flag field and the criteria field is set to 'manual' to protect values
from future automatic updates. |
| ui_datagrid |
Dialog for editing data in a GCE Data Structure and
logging all the changes |
| ui_dateplots |
GUI dialog for generating multiple date plots at various intervals from a time-series plot to generate bitmpap or vector image files. |
| ui_dateplots_html |
GUI dialog for generating multiple date plots at various intervals from a time-series plot in PNG format, and generating a multi-column HTML file with optional hyperlinked thumbnails to preview images. |
| ui_editmetadata |
Dialog for editing metadata stored in a GCE Data Structure. |
| ui_editor |
GCE Data Toolbox data structure editor for creating,
updating, and exporting data and documentation stored in GCE Data
Structures. Also contains links to specialized utility functions and
analysis tools. |
| ui_exportasc |
GCE Data Toolbox data structure ASCII export dialog. |
| ui_expclimdb |
GUI dialog for exporting data sets and flags as text files in LTER ClimDB/HydroDB format. |
| ui_flagdefs |
QA/QC flag definition and data anomalies editor dialog. |
| ui_gce_register |
GCE data download registration form dialog called by 'ui_search_data'. |
| ui_harvestclimdb |
GUI dialog for retrieving data from the LTER ClimDB/HydroDB
database. An updated lists of sites, stations and parameters can be updated on demand from
the ClimDB/HydroDB server, and then data from any station and time range can be retrieved to
create a GCE data structure for analysis and display.
(Note: MATLAB 6.5/Release 13 required) |
| ui_harvestusgs |
GUI dialog for harvesting data from the USGS WWW server. Real-time, daily and finalized data can be retrieved for any supported station for the specified number of days. A list of Real-time stations is provided for look-up by state.
(Note: MATLAB 6.5/R13 required) |
| ui_importfilter |
GUI dialog for customized importing of delimited ASCII text files. Support is provided for non-standard header formats and multiple missing value codes, and format strings and column titles can be automatically parsed or entered manually. An interactive file viewer display is also provided. |
| ui_joindata |
GUI dialog for joining columns in two GCE Data Structures
together based on common values in one or more key columns |
| ui_mapdata |
Data mapping dialog for the GCE Data Toolbox |
| ui_metastyle |
Dialog for creating, editing and managing metadata style
definitions which are used to generate formatted metadata for preview
and file export |
| ui_multimerge |
Dialog for merging multiple GCE Data Structures into a
single structure. The resultant structure will be opened in the GCE Data
Structure Editor. |
| ui_plotdata |
GCE Data Toolbox data structure plotting dialog |
| ui_plotgroups |
GCE Data Toolbox dialog for creating multiple line/scatter
plots for values in two columns of a GCE Data Structure, with one line
plotted for each distinct value in a series of one or more grouping
columns |
| ui_qcflags |
GUI dialog for editing QA/QC flag criteria for the
selected column |
| ui_querybuilder |
GUI dialog for building row restriction queries to
subselect data from a GCE Data Structure |
| ui_search_data |
GCE Search Engine dialog for building and querying metadata search indices to identify and retrieve data sets for analysis or transformation using GCE Data Toolbox
programs |
| ui_splitseries |
GUI dialog for splitting compound data series based on values in a specified column and serially joining subsets to form a standard table |
| ui_sortcolumns |
GUI dialog for sorting data columns in a GCE Data
Structure |
| ui_statreport |
GCE Data Toolbox statistical report generator dialog |
| ui_template |
GUI dialog for creating, editing and managing metadata
templates used by the data structure editor and import filters to assign
column descriptors and boilerplate metadata to new data structures based
on column name and unit matching |
| ui_title |
Dialog called by 'ui_editor' to update the title of a GCE
Data Structure |
| ui_topbottom |
GUI dialog for for extracting top and bottom data records
from a data structure containing vertical profile data based on values
in a depth or pressure column |
| ui_unitconv |
Unit conversion dialog called by 'ui_editor' (requires
data file ui_editor.mat) |
| ui_viewmeta |
Displays various metadata components of a GCE Data
Structure in a scrolling list box viewer |
| ui_visualqc |
Dialog for assigning and clearing QA/QC flags visually by
clicking on data points with the mouse after structure columns are
graphed as scatter/line plots using 'plotdata' or 'plotgroups' (note:
plots of encoded text columns are not supported) |
| Command-line Data Structure Tools |
| aggr_bindata |
Bins data by values in the specified numerical column
after aggregation by one or more grouping columns, and returns
statistical analyses of values within bins for the specified data
columns. The resultant structure will contain all aggregation columns
plus columns for upper bin limit, bin middle, and all relevant
statistics for selected data columns. Values outside of the bin range
will be omitted from the analysis. |
| aggr_datetime |
Sorts and aggregates data in a GCE-LTER data structure by the specified date/time interval after optionally grouping data by values in one or more columns, then calculates appropriate statistics within each group for the specified columns and generates a new data structure containing the results. |
| aggr_stats |
Sorts and aggregates data in a GCE-LTER data structure by
one or more columns, then calculates appropriate statistics within each
group for the specified columns and generates a new data structure
containing the results. |
| aggr_sums |
Sorts and aggregates data in a GCE-LTER data structure by
one or more columns, then optionally calculates sums within each group
for the specified columns and generates a new data structure containing
the results. Note that any columns in 'statcols' that are also listed in
'agcols' will be removed. |
| aggr_topbottom |
Returns top and bottom values for data columns in a data
structure based on values in a depth or pressure column, after
aggregation by one or more grouping columns |
| colstats |
Calculates basic descriptive statistics for columns in a
standard GCE-LTER data structure. |
| consolidate_cols |
Consolidates values in two compatible data columns by filling in null/NaN records from the first column with non-null/non-NaN records from the second. This function can be used to consolidate data in duplicate or equivalent data columns resulting from merge of join operations (e.g. data offsets resulting from merging data sets with differences in column name spelling). |
| convert_datatype |
Converts specified columns in a GCE Data Structure to a new data type, transforming values, numerical types, precisions and Q/C criteria as necessary |
| copycols |
Copies data from one or more columns in a GCE-LTER data
structure to form a new data structure or array. Can also be used to
duplicate, reorder, or remove columns (e.g. if data contains 4 columns,
'copycols(data,[4:-1:2 4])' will produce a new 4-column structure
containing columns 4,3,2,4 with corresponding header entries). |
| copyrows |
Copies data from one or more rows in a GCE-LTER data
structure to form a new data structure or array. Can also be used to
duplicate, reorder, or remove rows (e.g. if data contains 100 rows, 'copyrows(data,[1:50
100:-1:51])' will produce new structure with rows 51-100 in reverse
order). |
| datamerge |
Merges two GCE Data Structures to create a combined
structure, then applies the flagging criteria in the topmost structure
to the appended data values. |
| edit_unitconv |
Dialog for editing unit conversion tables used by the GCE
Data Toolbox. |
| insertrows |
Inserts rows of new data into specified columns of an existing GCE Data Structure,
padding corresponding rows in omitted columns with missing values (NaN/empty) |
| interp_missing |
Performs 1D interpolation to fill in missing values in a data series using a
specified method and flags the interpolated values as 'E' (estimated) |
| joindata |
Joins two data structures together by finding matching
data rows in one or more common (key) columns, and returns a structure
containing the key columns and the specified columns in both original
structures. Requires that the combination of values in key columns is
unique for each structure, and that the datatypes of key columns are the
same between structures (1:1 match). |
| merge_by_date |
Merges (i.e. concatenates) two GCE data structures based
on values in respective serial date columns to produce a single
structure with no overlapping date ranges. Note that overlapping date
values will be removed from the end of the structure with the earliest
beginning date regardless of differences in other columns to facilitate
automatic overwriting of provisional values. |
| multimerge |
Merges (concatenates) multiple GCE Data Structures specified by filename and structure name. |
| multi_templates |
Applies multiple, date-dependent metadata templates to a data set to accomodate parameter metadata changes |
| querydata |
Queries the values in a GCE-LTER data structure and
returns a new data structure containing only the resultant rows. |
| querystats |
Calculates descriptive statistics for values in a GCE-LTER
data structure after performing a query and selecting output columns. |
| rename_column |
Updates the name of a column in a GCE Data Structure, propagating the change
to any dependent Q/C flagging expressions. |
| search_data |
Identifies GCE Data Structures in one or more directories matching specified search criteria based on information stored in a search index structure, which will be created if necessary (see
'search_index'). |
| search_data_r13 |
Identifies GCE Data Structures in one or more directories matching specified search criteria based on information stored in a search index structure, which will be created if necessary (MATLAB 6.5/R13 or higher, see 'search_index_r13') |
| search_index |
Generates a data structure search index for 'search_data' by inspecting all MATLAB files in the specified directories, and optionally
subdirectories. |
| search_index_r13 |
Generates a data structure search index for 'search_data' by inspecting all MATLAB files in the specified directories, and optionally subdirectories (MATLAB 6.5/R13 or higher) |
| sortdata |
Performs multi-column, bidirectional sorting on rows in a
GCE Data Structure. |
| split_dataseries |
Splits a compound data series based on values in a specified column and serially joins subsets to form a standard table containing the specified data columns repeated for each unique split column value |
| update_data |
Updates values in a GCE Data Structure column, provided the data is compatible with the current column datatype, optionally logging all value changes to the processing history
field. |
| Command-line Data Structure Utilities |
| add_anomalies |
Documents flagged values by date for each specified parameter and stores the report in the Data/Anomalies section of the metadata |
| add_datecol |
Generates a vector of numerical dates from separate date
columns in a GCE Data Structure, and adds the values to the structure as
a calculated datetime column (i.e. Julian days). |
| add_datepartcols |
Adds numerical date part columns to a GCE Data Structure,
based on a single serial date column (base 1900 or base 0000). |
| add_latloncoords |
Adds latitude and longitude coordinates in degrees to a
GCE Data Structure containing geographic coordinates in UTM (m) |
| add_sitemetadata |
Adds or updates site metadata in a GCE Data Structure by
looking up values in a site column in a site metadata database file ('gce_coords_all.mat') |
| add_stationcoords |
Adds geographic coordinate columns to a data structure by matching station or location codes to entries in the GCE geographic database |
| add_studydates |
Adds study date metadata descriptors to a GCE Data Structure, based on the range of date values in the specified date/time
column |
| add_studysites |
Adds a column of GCE site codes to a data structure by matching values in geographic coordinate columns to site polygons from the GCE geographic database tables. |
| add_yeardaycol |
Adds a datetime column containing year day values (i.e. days since January 1 00:00 of a given year) calculated from a numerical or text serial date column. |
| add_utmcoords |
Adds geographic coordinates in UTM units to a GCE Data
Structure containing coordinates in lat/lon (decimal degrees) |
| add_calcexpr |
Evaluates a text expression and adds the resultant values
to a GCE Data Structure as a calculated column |
| addcol |
Adds a column array as a new calculated column to a
GCE-LTER data structure |
| addmeta |
Appends or updates metadata fields in a GCE-LTER data
structure |
| apply_template |
Applies a metadata template to a data structure, matching parameters by name and confirming data type and units compatibility |
| assign_numtype |
Automatically assigns numerical types and precisions to
columns in a GCE Data Structure with unassigned numbertype metadata
(value = 'unspecified'). |
| batch_import |
Processes all data files in a directory using the
specified file mask and import filter to create GCE Data Structures in a
single batch job |
| cleardupes |
Removes rows in a GCE s2 Structure in which the contents
of all specified columns are duplicated, preserving the first instance
of each group. Note that the structure will be sorted by the selected
columns, and all columns will be returned regardless of the comparison
column selections. |
| clearreps |
Replaces repeated values in the selected columns of a
GCE-LTER data structure with NaN, allowing values in sorting or
aggregating columns to be cleared during export. |
| close_gdt |
Closes all GCE Data Tools and optionally exits MATLAB |
| combine_ctdsurveys |
Combines CTD surveys within cruises to make multi-leg or multi-vessel surveys contiguous based on user-specified time and distance gaps between survey end-points, allowing for reversed directions of either survey. |
| compactcols |
Compacts a GCE Data Structure by eliminating columns in which all values are NaN or '' |
| compactrows |
Compacts a GCE Data Structure by eliminating rows in the
structure in which all indicated data columns contain NaN or '' (note:
all columns will be returned regardless of 'datacols' selection) |
| consolidate_cols |
Consolidates values in two compatible data columns by filling in null/NaN records from the first column with non-null/non-NaN records from the second. This function can be used to consolidate data in duplicate or equivalent data columns resulting from merge of join operations (e.g. data offsets resulting from merging data sets with differences in column name spelling). |
| copyflags |
Copies composite flags from one or more columns and adds to or replaces the existing flag arrays of one or more other columns (used to propagate flags to dependent/calculated columns) |
| cullflags |
Produces a new GCE-LTER data structure with any rows
containing flagged values removed |
| dataflag |
Reads the value flagging criteria in a GCE-LTER data
structure and (re)generates an array of user-defined flags |
| dupe_index |
Returns an index of records in a GCE Data Structure with duplicate values in all or specified columns. |
| encodestrings |
Encodes text columns in a GCE data structure as series of
unique integers and documents the code values in the Data_ValueCodes
section of the metadata |
| extract |
Extracts a single numbered or named column from a GCE-LTER
data structure |
| fill_meta_tokens |
Replaces tokens in metadata templates with text from the corresponding metadata fields (e.g. [Study_BeginDate] in Dataset_Title replaced with contents of Study_BeginDate metadata field) |
| fixprec |
Sets numerical precision of specified columns in a GCE
Data Structure equal to the display precision by rounding or truncation |
| gce_sitemetadata |
Returns formatted site descriptor metadata for a list of
GCE-LTER sampling sites (requires the file 'gce_coords_all.mat' be
present in the MATLAB path) |
| gce_stationmeta |
Returns formatted site descriptor metadata for a list of GCE-LTER sampling locations (requires the file 'gce_locations.mat' be present in the MATLAB path) |
| gce_valid |
Identifies and validates a GCE-LTER Data or Stat Structure
by checking for required fields and verifying the correspondence of
column and row elements in each value field. |
| listcols |
Returns a array of numbers and names of all the columns in
a GCE-LTER data structure using the specified output format |
| listdatacols |
Returns an index of data and/or calculation columns (dependent variables) in a GCE Data Structure or optionally returns an inverse index (i.e. index of non-data and non-calculation columns) |
| listhist |
Lists the contents of the history field from a GCE-LTER
Data Structure as a formatted character array, using the date format
specified (default = 0) |
| listmeta |
Generates formatted metadata from values stored in a GCE
Data or Stat structure |
| lookupmeta |
Looks up metadata in a GCE Data or Stat Structure by
category and fieldname |
| make_template |
Parses a tab-delimited text file with the following column
headings to create a data descriptor metadata template structure |
| match_sites |
Matches the coordinates given by lon and lat to GCE
super-site polygons in coords and returns a cell array of site codes |
| maxrows |
Returns a maximum of 'maxrownum' rows from a GCE-LTER data
structure 'data' |
| mergemeta |
Merges metadata in a GCE Data structure following a data
merge or join |
| meta_template |
Generates data descriptor metadata for a GCE Data
Structure by matching supplied variable names to records in a named
metadata template stored in 'imp_templates.mat' or another data
structure used as a template |
| name2col |
Returns an array of column numbers for column names in a
GCE-LTER data structure matching the strings in the cell array 'colnames'
(case insensitive) |
| negative2zero |
Converts negative values in the specified columns of a GCE Data Structure to zeros |
| newstruct |
Creates an empty GCE data or stat structure, containing
all default fields |
| newtitle |
Updates the title of a GCE Data or Stat Structure with the
specified string |
| nullflags |
Produces a new GCE-LTER data structure with any flagged
values converted to nulls (NaN) |
| previewdata |
Displays a preview of formatted data in a scrolling text
box control. |
| syncpath |
Synchronizes path cache information between GCE Data Toolbox editor windows |
| unitconv |
Performs unit conversions on the specified column of a GCE
Data Structure using the specified multiplier or expression. If no
multiplier or expression is supplied, a standard conversion will be
performed by matching original and new units in the file 'ui_unitconv.mat'
(if present). If more than one column is specified, batch English to
Metric or Metric to English conversions are applied according to the
input option. Conversion expressions are documented in the 'Data'|'Calculations'
section of the metadata. |
| viewstats |
Displays ungrouped column statistics for a GCE data
structure in a scrollable text box. |
| Import Filters and Utilities |
| *** NOTE: some
functions are not included in the default installation *** |
| csi2struct |
Parses data arrays in a Campbell Scientific Instruments
array-based data logger file and adds documentation and attribute-level
metadata based on information stored in 'csi2struct.mat' |
| fetch_climdb_data |
Retrieves updated status information on sites, stations and variables from the LTER ClimDB/HyroDB web site
(requires networking and xml functions in MATLAB 6.5/R13 or higher) |
| fetch_climdb_info |
Fetches data for a specified site and station from the ClimDB/HydroDB web site
(requires networking features in MATLAB 6.5/R13 or higher) |
| fetch_usgs |
Retrieves real-time, daily or finalized data from the USGS WWW
server for any real-time station across the US, and calls the 'parse_usgs'
function to generate a GCE Data Structure (requires MATLAB 6.5/R13) |
| imp_ascii |
Reads a tab or space-delimited text file to create a GCE
Data Structure. |
| imp_ctdprofile |
Inputs: Reads variables in a CTD profile data file and concatenates
them to form a GCE Data Structure with standard data
descriptor metadata (called by 'ds_editor'). |
| imp_datastruct |
Retrieves a GCE Data Structure from a MATLAB binary file.
If no variable names 'data' is present, the first valid data structure
will be returned. |
| imp_filter |
Imports data from a delimited ASCII File using a specified
format string and list of column names to create a GCE Data Structure.
Optionally replaces one or more missing value codes with 'NaN' and
applies a named metadata template to assign column descriptors and
import general metadata. |
| imp_gcesonde |
Imports the data and header from a processed SBE SM-37
Microcat data file (.asc) to create a GCE Data Structure |
| imp_matlab |
Reads selected variables in a MATLAB binary file to form a
GCE Data Structure. Cell and numerical arrays and matrices are both
supported, but the number of rows in all selected variables must match.
Basic data descriptor metadata is determined automatically by value
inspection. |
| imp_ncdc_climate |
Imports climate data from a NCDC daily summary file to
create a GCE Data Structure. Note that the file must first be edited to
remove empty lines and extended lines containing extra parameters, and
the extra parameter entries removed from the header row as well. |
| imp_sabsoon |
Reads variables in a SABSOON data file and concatenates them to form a GCE Data Structure with standard data descriptor metadata
assigned by matching variables to the 'SABSOON' template in 'imp_templates'.
Metadata for unmatched columns is determined automatically by value
inspection. Note that any only vectors the same length as 'year' will be
imported (other variables will be ignored). |
| imp_usgsdoctortown |
Imports tab-delimited data from the USGS gauging station at
Doctortown, assigning data descriptor metadata for all columns based on
the 'USGS_Doctortown' template. |
| imp_usgshudson |
Imports tab-delimited data from the USGS Hudson Creek
Superstation, assigning data descriptor metadata for all columns based
on the 'USGS' template, splits the imported data into two structures ('s_met'
and 's_hydro'), and compacts each structure to eliminate entirely empty
data rows. |
| parse_37sm |
Parses a processed data file (.asc) from a Seabird
Electronics 37-SM Microcat and returns a standard data matrix and header
array. |
| parse_usgs |
Parses tab-delimited real-time or daily data obtained from the USGS water data web site to create a GCE Data Structure. If no template is specified a generic template containing column descriptors for common hydrographic and meteorological parameters will be used. |
| parseheader |
Parses delimited header information in an ASCII file |
| prf2mat |
Reads an ASCII file in DiIorio PRF format and returns the
data matrix prepended with 8 metadata columns derived from the header
section of each data segment (i.e. replicated for each data row),
optionally compacting the output matrix by omitting empty data rows. |
| readheader |
Reads a text file containing delimited header and metadata
fields ([category_field]:[value]) for updating the metadata field in a
GCE-LTER data structure. See 'readdata.m'. |
| readmeta |
Reads a text file containing delimited metadata fields ([category_field]:[value])
for updating the metadata field in a GCE-LTER data structure. |
| split_csi |
Scans through a Campbell Scientific Instruments
array-based data logger file and write individual data files for each
for the specified data arrays (alternative to the CSI Split utility) |
| Export Filters and Utilities |
| exp_ascii |
Exports the information in a GCE-LTER data or stat
structure in the specified format |
| exp_climdb |
Exports climate and/or hydrographic monitoring data in LTER ClimDB harvester format. Data will be resampled to daily intervals if necessary, and column names and units will be converted to ClimDB equivalents based on the lookup table stored in the data structure 'exp_climdb.mat'. |
| exp_matlab |
Exports the contents of a GCE Data Structure as a standard MATLAB
data file containing data and metadata as variables |
| exportfig |
Exports the active plot figure in a variety of formats and
resolutions, with printing of uicontrol elements suppressed |
| Quality Control Flagging Functions |
| flag_locationcoords |
Returns an index of location codes with coordinates that differ by more the specified tolerance from reference coordinates |
| flag_o2saturation |
Returns index of dissolved oxygen concentration values
that are above or below the temperature and salinity-dependent
saturation concentration by the specified percentages (requires columns
containing oxygen conc. in mg/L, temperature in °C, and salinity in PSU,
and calls the function 'o2_saturation') |
| flag_notinlist |
Returns indices of string values in a cell array that are not present in a list array or file-based list. |
| flag_nsigma |
Returns indices of values in an array that are above or
below the mean value of nearby values by the specified number of
standard deviations |
| flag_percentchange |
Returns indices of values in an array that are above or
below the mean value of nearby values by the specified percentage |
| flag_valuechange |
Returns indices of values in an array that are above or
below the mean value of nearby values by the specified number |
| flags2cols |
Converts QC flag information in a GCE Data Structure to a
string column with appropriate metadata information |
| Data Structure Plotting Functions |
| plotbuttons |
Adds a custom toolbar to the bottom of the current plot,
providing constrained zoom, pan and date axis formatting contro |
| plotdata |
Generates 2D symbol/line plots of values in a GCE-LTER
data structure |
| plotgroups |
Creates multiple line/scatter plots for values in two
columns of a GCE Data Structure, with one line plotted for each distinct
value in a series of one or more grouping columns |
| plothistogram |
Plots a frequency histogram for the indicated column in a
GCE Data Structure |
| Miscellaneous Data Structure Batch
Utilities and Scripts |
| dataproc |
Reads a tab or space-delimitted text file with a
standardized header to create a GCE-LTER data structure, calculate
standard descriptive statistics, and optional save the results as MATLAB and/or text files. |
| dateplots |
Generates individual date plots for a specified interval from a standard date plot and saves each plot as a bitmap or vector image file in the specified format and resolution (supercedes 'monthplotsfig' and 'yearplotsfig') |
| dateplot2html |
Generates an HTML page and image files, with optional hyperlinked thumbnails, to represent time series data plots for a specified interval on a web page |
| dateplot2template |
Generates an HTML page and image files, with optional hyperlinked thumbnails, to represent time series data plots for a specified interval on a web page based on a specified HTML template. |
| daterange2str |
Generates textual descriptions of ranges of serial dates based on a selection index. |
| monthplots |
Generates monthly date plots for a multiple parameters in
a GCE data structure, and saves the figures as a series of .png files |
| monthplotsfig |
Generates individual monthly date plots from a standard
date plot and saves each plot as a .png file |
| restart |
Re-opens the GCE Data Toolbox start screen (calls ui_aboutgce). |
| sitedateplots |
Generates a standard date plot for a single parameter in a
GCE data structure grouped by site, saves the figure as a MATLAB .fig
file and a .png file, and steps through the specified date interval to
create multiple .png files zoomed in by date |
| sonde_batch |
Processes all uploaded SBE 37-SM sonde files (*.asc) in a
directory to create GCE Data Structures with standard metadata using the
'imp_gcesonde' function |
| gce_distribfiles |
Creates standard set of ASCII and MATLAB distribution
files for all data structures in the specified directory |
| startup |
Startup script that adds the GCE Data Toolbox directory to
the MATLAB path and opens a data structure editor window |
| XML Utilities for MATLAB (experimental) |
| meta2struct |
Converts an n x 3 cell array containing GCE-LTER metadata
into a hierarchically-nested structure with fields named according to
metadata category and field names. |
| neststruct |
Nests a child structure in a specified field of a parent
structure based on matching values in a shared key field |
| struct2xml |
Generates xml-formatted text from nested multidimensional
structures, using field names for xml tags, with each structure
dimension wrapped in the specified parent tag |
| xml2file |
Writes an an xml string generated by 'struct2xml' to disk
as a well-formed xml document |
| Miscellaneous MATLAB support
functions |
| angleavg |
Calculates a vector average for angular data using the
formula: vecavg(d) = atan2(mean(sin(d)),mean(cos(d))) |
| bbox2sites |
Returns a list of GCE study sites with bounding polygons intersecting a specified rectangular bounding box. |
| cell2commas |
Concatenates elements in a cell array of strings to form a
single comma- separated character array (Note that multidimensional
arrays will be concatenated by column and then row) |
| cell2pipes |
Concatenates elements in a cell array of strings to form a
single character array separated with padding spaces and pipe characters
for word-wrapping by the 'listmeta' function. Note that multidimensional
arrays will be concatenated by column and then row. |
| centerstr |
Centers two character arrays |
| clipplottext |
Manually clip text on a 2D plot by toggling the visibility
on or off based on axis position |
| compress_string |
Removes all blanks from a character array or cell array of strings and truncates and left over padding spaces |
| concatcellcols |
Concatenates individual cells on each row in a cell array
of strings to form a single column array |
| confirmdlg |
Confirmation dialog that executes 'callback' statement if
the 'OK' button is pressed |
| date2yearday |
Converts a MATLAB serial date to the corresponding Julian Day/Year Day |
| dateaxis |
Refreshes date ticks on the x-axis of the current plot |
| datecnv |
Converts numerical dates between various software
conventions |
| daterange2str |
Generates textual descriptions of ranges of serial dates based on a selection index |
| ddeg2dms |
Converts geographic coordinates from decimal degrees to
degrees, minutes, seconds |
| dec_places |
Determines the maximum number of used decimal places in a floating-point number, up to the specified maximum precision |
| deg2utm |
Converts geographic coordinates from decimal degrees to
UTM components using specified ellipsoid datum |
| file2listbox |
Loads an ASCII file and displays it in a uicontrol listbox (see ui_viewtext) |
| insidepoly |
Determines if points are inside/outside a polygon |
| listbox2file |
Saves the string contents of a listbox uicontrol as an ASCII text file |
| listdialog |
General dialog for selecting values from a GUI list |
| messagebox |
Generates a multiline message box. If op is 'init' the
message box is created with the string in 'message' displayed. The
single 'OK' button closes the box, shifts focus back to the eliciting
figure window, and issues the optional 'callback' statement. The
optional arguments 'dialogtitle' and 'bgcolor' specify the window title
and background color of the messaage box, resp. |
| mfilecatalog |
Generates a catalog of mfiles in the specified directory
as an ASCII file. |
| o2_saturation |
Calculates dissolved oxygen saturation as a function of
temperature and salinity
at sea-level (based on Sea-Bird Electronics, Inc. Application Note 64,
Sept 2002) |
| parent_figure |
Determines the parent figure for any uicontrol handle (returns empty matrix if handle or figure don't exist) |
| plotbuttons |
Adds a custom toolbar to the bottom of the current plot, providing constrained zoom, pan and date axis formatting control |
| plotlabels |
Adds the specified title and axis label strings to the current plot and links each string object to the editing function
'textedit.m' |
| plotmenu |
Adds a menu item to a MATLAB figure containing commands for exporting figures in various vector and bitmap formats, toggling axis gridlines, and generating serial date plots are various intervals as images with or without accompanying HTML pages and thumbnail previews. |
| plotwidgets |
Creates or removes standard GCE plot menus and toolbars from a MATLAB figure |
| roundsig |
Rounds 'x' to the significant digits 'sigdig' |
| setpath |
Adds the current directory to the MATLAB path (option =
'beginning' prepends (default), option = 'end' appends) |
| splitcodes |
Parses a delimited string containing code name, code value pairs and returns matching name and value arrays. |
| splitstr |
Splits a character array into elements based on positions
of a specified delimiter, and returns the results as a cell array of
strings with any blank elements removed |
| textedit |
Text editing dialog box, to be used as a callback function
associated with text objects. |
| textfile2cell |
Reads the specified text file, and returns a MATLAB cell
array with lines optionally word-wrapped at the specified margin. |
| trimstr |
Trims leading and trailing blanks from a character array or each string in a cell array of strings. |
| t_value_onetail |
Returns the area under the Student t distribution (single side) for a given alpha and degrees of freedom |
| ui_progressbar |
Creates a graphical progress bar to illustrate the status of long-running processes. |
| ui_text_prompt |
Opens a dialog box to prompt for a character array. |
| ui_viewtext |
Displays a string or array of strings in a scrolling list
box viewer |
| utm2deg |
Converts geographic coordinates from UTM to decimal
degrees based on the specified ellipsoid datum |
| wordwrap |
Wraps lines of text at word breaks with optional
indentation |
| yearday2date |
Converts a Julian Day/Year Day for the specified year to a MATLAB serial date |
|
