-------------- READ-ME file for the TAMUoic2019 database ---------------

 This is an extention kernel of a database of the single-scattering 
 properties of oriented ice crystals (OIC). The two major oriented 
 particles, horizontally oriented plates (HOP) and columns (HOC), are 
 considered in the database. 


 Lead developer: Dr. Masanori Saito (masa.saito@tamu.edu)
 PI: 		 Dr. Ping Yang 


 History
 (MM/DD/YYYY)	(Author)	(Contents)
 02/01/2018	Masa Saito	Project initiated.
 12/10/2018 	Masa Saito	HOP completed. 
 03/01/2019	Masa Saito	HOC completed. 
 07/10/2019	Masa Saito	Version 1.0.0 Released.
 04/18/2021	Masa Saito	Encoder and kernel technique 
                                implemented.
 04/24/2021	Masa Saito	Version 1.1.0 Released.


 
1. General information

   The TAMUoic2019 database includes the single-scattering properties
   of oriented ice crystals. This database is useful for users who 
   would like to consider horizontally oriented ice crystals in ice 
   clouds in various radiative transfer simulations such as lidar 
   signals and brightness distributions on the sky. Several example 
   simulations are performed and summarized in the following paper.

   Reference:

     1). Saito, M., and P. Yang (2019), Oriented ice crystals: A 
         single-scattering property database for applications to lidar
         and optical phenomenon simulations, J. Atmos. Sci., 76, 
         2635--2652.



2. Unzip

   To utilize the TAMUoic2019 database, please firt download 
   TAMUoic2019 encoder and scaler kernel (https://doi.org/10.5281/
   zenodo.4718022). Place the compressed extension kernel at 
   ./TAMUoic2019 and type

     $  tar xzvf {TAMUoic2019_Extension_Kernel}.tar.gz

   Then, the extension kernel appears at ./TAMUoic2019/table/


3. Contact Information

   Dr. Masanori Saito (masa.saito@tamu.edu) 
   Department of Atmospheric Sciences, Texas A&M University.