<html>
  <head>

    <meta http-equiv="content-type" content="text/html; charset=utf-8">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    hello dart users --<br>
    <br>
    if you're not a beta user of the dart rma_trunk branch <br>
    you can ignore the rest of this note.  have a great day!<br>
    <br>
    <br>
    i've just committed an invasive change to the rma_trunk<br>
    branch.  and be warned - we have 2 more substantial<br>
    changes coming in the next few days.  my apologies in<br>
    advance to our beta users of the rma_branch.  if we make <br>
    changes that you can't figure out how to patch yourself, <br>
    (or don't want to), please please email <a class="moz-txt-link-abbreviated" href="mailto:dart@ucar.edu">dart@ucar.edu</a> and <br>
    we'll help you migrate your code to our current version.<br>
    <br>
    today's changes:<br>
    <br>
    our use of types and kinds has been very confusing in<br>
    the past.  the massive rename i just committed is an<br>
    attempt to make it clearer which things in dart are generic<br>
    quantities - temperature, pressure, etc - and which things<br>
    are specific types of observations - radiosonde_temperature,<br>
    argo_salinity etc.<br>
    <br>
    i'm appending the mapping between old and new names<br>
    here for reference.   i've made these changes to all files<br>
    in the dart subversion repository on the rma_trunk branch.<br>
    but for your files that aren't in our repository, here are the<br>
    things that need to be renamed.  if you have lots of code<br>
    email me for my sed script to help automate the changes.  <br>
    <br>
    thanks, n.<br>
    <br>
    <tt><br>
    </tt><tt>public subroutines, existing name on left, replacement on
      right:</tt><tt><br>
    </tt><tt><br>
    </tt><tt>assimilate_this_obs_kind()     =&gt;    
      assimilate_this_type_of_obs(type_index)</tt><tt><br>
    </tt><tt>evaluate_this_obs_kind()       =&gt;      
      evaluate_this_type_of_obs(type_index)</tt><tt><br>
    </tt><tt>use_ext_prior_this_obs_kind()  =&gt; 
      use_ext_prior_this_type_of_obs(type_index)</tt><tt><br>
    </tt><tt><br>
    </tt><tt>get_num_obs_kinds()      =&gt;  get_num_types_of_obs()</tt><tt><br>
    </tt><tt>get_num_raw_obs_kinds()  =&gt;  get_num_quantities()</tt><tt><br>
    </tt><tt><br>
    </tt><tt>get_obs_kind_index()     =&gt;
      get_index_for_type_of_obs(type_name)</tt><tt><br>
    </tt><tt>get_obs_kind_name()      =&gt;
      get_name_for_type_of_obs(type_index)</tt><tt><br>
    </tt><tt><br>
    </tt><tt>get_raw_obs_kind_index()  =&gt;  get_index_for_quantity(qty_name)</tt><tt><br>
    </tt><tt>get_raw_obs_kind_name()   =&gt;  get_name_for_quantity(qty_index)</tt><tt><br>
    </tt><tt><br>
    </tt><tt>get_obs_kind_var_type()  =&gt; 
      get_quantity_for_type_of_obs(type_index)</tt><tt><br>
    </tt><tt><br>
    </tt><tt>get_obs_kind()      =&gt;  get_obs_def_type_of_obs(obs_def)</tt><tt><br>
    </tt><tt>set_obs_def_kind()  =&gt;  set_obs_def_type_of_obs(obs_def)</tt><tt><br>
    </tt><tt><br>
    </tt><tt>get_kind_from_menu()      =&gt; 
      get_type_of_obs_from_menu()</tt><tt><br>
    </tt><tt><br>
    </tt><tt>read_obs_kind()     =&gt;  
      read_type_of_obs_table(file_unit, file_format)</tt><tt><br>
    </tt><tt>write_obs_kind()    =&gt; 
      write_type_of_obs_table(file_unit, file_format)</tt><tt><br>
    </tt><tt><br>
    </tt><tt>maps obs_seq nums to specific type nums, only used in
      read_obs_seq:</tt><tt><br>
    </tt><tt>map_def_index()  =&gt; map_type_of_obs_table()</tt><tt><br>
    </tt><tt><br>
    </tt><tt>removed this.  apparently unused, and simply calls
      get_obs_kind_name():</tt><tt><br>
    </tt><tt>get_obs_name()</tt><tt><br>
    </tt><tt><br>
    </tt><tt>apparently unused anywhere, removed:</tt><tt><br>
    </tt><tt>add_wind_names()</tt><tt><br>
    </tt><tt>do_obs_form_pair()</tt><tt><br>
    </tt><tt><br>
    </tt><tt>public integer parameter constants and subroutine formal
      argument names,</tt><tt><br>
    </tt><tt>old on left, new on right:</tt><tt><br>
    </tt><tt><br>
    </tt><tt>KIND_ =&gt; QTY_</tt><tt><br>
    </tt><tt>kind =&gt; quantity</tt><tt><br>
    </tt><tt><br>
    </tt><tt>TYPE_ =&gt; TYPE_</tt><tt><br>
    </tt><tt>type =&gt; type_of_obs</tt><tt><br>
    </tt><tt><br>
    </tt><tt>integer parameters:</tt><tt><br>
    </tt><tt>max_obs_generic  =&gt;  max_defined_quantities  (not
      currently public, stays private)</tt><tt><br>
    </tt><tt>max_obs_kinds    =&gt;  max_defined_types_of_obs  </tt><br>
    <br>
  </body>
</html>