$extrastylesheet
Dakota
Version 6.2
|
Utility functions for reading and writing tabular data files Emerging utilities for tabular file I/O. For now, just extraction of capability from separate contexts to faciliate rework. These augment (and leverage) those in data_util.h. More...
Namespaces | |
namespace | Dakota |
The primary namespace for DAKOTA. | |
Functions | |
String | format_name (unsigned short tabular_format) |
Translate tabular_format into a user-friendly name. | |
void | print_expected_format (std::ostream &s, unsigned short tabular_format, size_t num_rows, size_t num_cols) |
Describe the expected data file format based on passed parameters. | |
void | print_unexpected_data (std::ostream &s, const String &filename, const String &context_message, unsigned short tabular_format) |
Print a warning if there's extra data in the file. | |
void | open_file (std::ifstream &data_file, const std::string &input_filename, const std::string &context_message) |
open the file specified by name for reading, using passed input stream, presenting context-specific error on failure | |
void | open_file (std::ofstream &data_file, const std::string &output_filename, const std::string &context_message) |
open the file specified by name for writing, using passed output stream, presenting context-specific error on failure | |
void | write_header_tabular (std::ostream &tabular_ostream, const Variables &vars, const Response &response, const std::string &counter_label, unsigned short tabular_format) |
Output the header row (labels) for a tabular data file, with variables in input spec order. Conditionally include interface ID. Primary uses: environment tabular data, pre-run output, surrogate approx evals. | |
void | write_leading_columns (std::ostream &tabular_ostream, size_t eval_id, const String &iface_id, unsigned short tabular_format) |
Write the leading column with eval ID and conditionally, the interface ID. | |
void | write_data_tabular (std::ostream &tabular_ostream, const Variables &vars, const String &iface, const Response &response, size_t counter, unsigned short tabular_format) |
Output a row of tabular data from variables and response object used by graphics to append to tabular file during iteration. All active/inactive variables written in input spec order. Conditionally include interface ID. Primary uses: environment tabular data, pre-run output, surrogate approx evals. | |
void | write_data_tabular (const std::string &output_filename, const std::string &context_message, const RealVectorArray &output_coeffs, const UShort2DArray &output_indices) |
PCE export: write freeform format file with whitespace-separated data where each row has num_fns reals from coeffs, followed by num_vars unsigned shorts from indices. | |
bool | exists_extra_data (std::istream &tabular_file) |
Check if an input stream contains unexpected additional data. | |
void | read_header_tabular (std::istream &input_stream, unsigned short tabular_format) |
read and discard header line from the stream | |
size_t | read_leading_columns (std::istream &input_stream, unsigned short tabular_format) |
read leading columns [ int eval_id [ String iface_id ] ] | |
void | read_data_tabular (const std::string &input_filename, const std::string &context_message, RealVector &input_data, size_t num_entries, unsigned short tabular_format) |
read possibly header-annotated whitespace-separated data into a vector of length num_entries; if annotated then it's a column vector for now | |
void | read_data_tabular (const std::string &input_filename, const std::string &context_message, Variables vars, size_t num_fns, RealArray &input_vector, unsigned short tabular_format, bool active_only) |
read possibly header-annotated whitespace-separated data of Variables, followed by num_fns, into a dynamic vector with minimal error checking | |
void | read_data_tabular (const std::string &input_filename, const std::string &context_message, RealVectorArray &input_coeffs, UShort2DArray &input_indices, unsigned short tabular_format, size_t num_vars, size_t num_fns) |
PCE import: read possibly header-annotated whitespace-separated data of unknown length where each row has num_fns reals followed by num_vars unsigned shorts; append data to arrays passed by reference. | |
void | read_data_tabular (const std::string &input_filename, const std::string &context_message, Variables vars, Response resp, VariablesList &input_vars, ResponseList &input_resp, unsigned short tabular_format, bool verbose=false, bool active_only=false) |
read whitespace-separated data with optional row and column headers into lists of Variables and Responses until out of data; continuous variables only | |
void | read_data_tabular (const std::string &input_filename, const std::string &context_message, RealMatrix &input_matrix, size_t num_rows, size_t num_cols, unsigned short tabular_format, bool verbose=false) |
read whitespace-separated data with optional row and column headers into a single matrix | |
size_t | read_data_tabular (const std::string &input_filename, const std::string &context_message, RealVectorArray &cva, IntVectorArray &diva, StringMulti2DArray &dsva, RealVectorArray &drva, unsigned short tabular_format, bool active_only, Variables vars) |
read specified input data file into arrays with sizes specified by the passed vc_totals array; used in ParamStudy |
Utility functions for reading and writing tabular data files Emerging utilities for tabular file I/O. For now, just extraction of capability from separate contexts to faciliate rework. These augment (and leverage) those in data_util.h.
Design/capability goals: Ability to read / write data with row/col headers or in free-form Detect premature end of file, report if extra data More consistent and reliable checks for file open errors Require right number of cols in header mode; only total data checking in free-form (likely) Allow comment character for header rows or even in data? variables vs. variables/responses for both read and write Should we support CSV? delimiter = ','; other? Verify treatment of trailing newline without reading a zero Allow reading into the transpose of the data structure