This codebook.txt file was generated on 2018-03-22 by wilsonkm

-------------------
GENERAL INFORMATION
-------------------

1. Title of Dataset 
TIEGCM-ROM

Please note - TIEGCM: Thermosphere-Ionosphere-Electrodynamics Global Circulation Model

2. Author Information

  Principal Investigator Contact Information
        Name: Piyush M. Mehta
           Institution: University of Minnesota, Aerospace Engineering and Mechanics
           Address: 
           Email: piyushmukeshmehta@gmail.com

3. Date of data collection: N/A

4. Geographic location of data collection: N/A 

5. Information about funding sources that supported the collection of the data:
Sponsorship: DOD: Air Force Office of Scientific Research

--------------------------
SHARING/ACCESS INFORMATION
-------------------------- 

1. Licenses/restrictions placed on the data:
CC0 1.0 Universal

2. Links to publications that cite or use the data:
Mehta, P. M., Linares, R. L., and Sutton, E. K., A quasi-physical dynamic reduced order model for thermospheric mass density via Hermitian Space Dynamic Mode Decomposition, under review, Space Weather.


3. Links to other publicly accessible locations of the data: N/A


4. Links/relationships to ancillary data sets: N/A


5. Was data derived from another source? N/A

6. Recommended citation for the data: 

Mehta, Piyush M.. (2018). TIEGCM-ROM. Retrieved from the Data Repository for the University of Minnesota, http://hdl.handle.net/11299/194705.

---------------------
DATA & FILE OVERVIEW
---------------------

1. File List
	A. Filename: HS-DMDc_TIEGCM.zip       
	Short description: Archive file. 
	Contains two files:
		1. HS_DMDc.m
			This is a matlab script that reads in the variables in TIE_GCM_ROM.mat and computes the reduced order dynamic and input matrices A and B for a reduced order model for TIE-GCM. The user needs to define the values of ri (r_hat) and r as described in the accompanying paper. The script also describe and define the variables in the TIE_GCM_ROM.mat file.

		2. TIE_GCM_ROM.mat
			This file contains the variables to compute the full and reduced rank dynamic and input matrices for a reduced order representation of the Thermosphere-Ionosphere-Electrodynamics Global Circulation Model (TIEGCM).


2. Relationship between files:        


3. Additional related data collected that was not included in the current data package:
N/A

4. Are there multiple versions of the dataset? No

--------------------------
METHODOLOGICAL INFORMATION
--------------------------
1. Description of methods used for collection/generation of data: 
The data included in the mat file was obtained using 12 years of TIE-GCM model simulations. TIE-GCM is an open source, freely available physical model of the Ionosphere-Thermosphere that is widely and commonly used in the scientific community. More information about the model can be found in the following reference.

Qian, L., A. G. Burns, B. A. Emery, B. Foster, G. Lu, A. Maute, A. D. Richmond, R. G. Roble,
S. C. Solomon, and W. Wangm, (2014). The NCAR TIE-GCM: A community model of the coupled thermosphere/ionosphere system, in Modeling the Ionosphere-Thermosphere System, \textit{AGU Geophysical Monograph Series}, 2014.



2. Methods for processing the data:  Data Processing Methods are described in detailed in the accompanying paper currently under review for publication in AGU space weather journal. The paper can currently be referenced as:

Mehta, P. M., Linares, R. L., and Sutton, E. K., (2018). A quasi-physical dynamic reduced order model for thermosphere mass density via Hermitian Space Dynamic Mode Decomposition, under review, Space Weather.


3. Instrument- or software-specific information needed to interpret the data:
MATLAB


4. Standards and calibration information, if appropriate:


5. Environmental/experimental conditions:


6. Describe any quality-assurance procedures performed on the data:


7. People involved with sample collection, processing, analysis and/or submission:  The TIE-GCM simulation output was provided by Eric Sutton (co-author) on the accompanying paper where the development of the reduced order model is described.