<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() =>
assimilate_this_type_of_obs(type_index)</tt><tt><br>
</tt><tt>evaluate_this_obs_kind() =>
evaluate_this_type_of_obs(type_index)</tt><tt><br>
</tt><tt>use_ext_prior_this_obs_kind() =>
use_ext_prior_this_type_of_obs(type_index)</tt><tt><br>
</tt><tt><br>
</tt><tt>get_num_obs_kinds() => get_num_types_of_obs()</tt><tt><br>
</tt><tt>get_num_raw_obs_kinds() => get_num_quantities()</tt><tt><br>
</tt><tt><br>
</tt><tt>get_obs_kind_index() =>
get_index_for_type_of_obs(type_name)</tt><tt><br>
</tt><tt>get_obs_kind_name() =>
get_name_for_type_of_obs(type_index)</tt><tt><br>
</tt><tt><br>
</tt><tt>get_raw_obs_kind_index() => get_index_for_quantity(qty_name)</tt><tt><br>
</tt><tt>get_raw_obs_kind_name() => get_name_for_quantity(qty_index)</tt><tt><br>
</tt><tt><br>
</tt><tt>get_obs_kind_var_type() =>
get_quantity_for_type_of_obs(type_index)</tt><tt><br>
</tt><tt><br>
</tt><tt>get_obs_kind() => get_obs_def_type_of_obs(obs_def)</tt><tt><br>
</tt><tt>set_obs_def_kind() => set_obs_def_type_of_obs(obs_def)</tt><tt><br>
</tt><tt><br>
</tt><tt>get_kind_from_menu() =>
get_type_of_obs_from_menu()</tt><tt><br>
</tt><tt><br>
</tt><tt>read_obs_kind() =>
read_type_of_obs_table(file_unit, file_format)</tt><tt><br>
</tt><tt>write_obs_kind() =>
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() => 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_ => QTY_</tt><tt><br>
</tt><tt>kind => quantity</tt><tt><br>
</tt><tt><br>
</tt><tt>TYPE_ => TYPE_</tt><tt><br>
</tt><tt>type => type_of_obs</tt><tt><br>
</tt><tt><br>
</tt><tt>integer parameters:</tt><tt><br>
</tt><tt>max_obs_generic => max_defined_quantities (not
currently public, stays private)</tt><tt><br>
</tt><tt>max_obs_kinds => max_defined_types_of_obs </tt><br>
<br>
</body>
</html>