Re: theta_fo documentation mismatch

[ansley@xxxxxxxxxxxxx (Ansley Manke)]

Keith,
Thanks for bringing this to our attention.  The arguments to THETA_FO are 
correct in the Users Guide.  

THETA_FO( salt, temp, Z, Z_reference )

Where Z should refer to Pressure and Z_reference to reference temperature

The code lists these units, and a checkvalue

C UNITS:
C	PRESSURE	PO	DECIBARS
C	TEMPERATURE	TO	DEG CELSIUS (IPTS-68)
C	SALINITY	S	(PSS-78)
C	REFERENCE PRS	PR	DECIBARS
C	POTENTIAL TEMP	THETA	DEG CELSIUS
C
C CHECKVALUE: THETA=36.89073 DEG C:  S=40(PSS-78), TO=40 DEG C,
C	


And indeed when calling the function from Ferret:

yes? list theta_fo(40, 40, 10000, 0)
             THETA_FO(40, 40, 10000, 0)
          36.89


We'll get this corrected in the Ferret code which documents the function!


Ansley Manke



Keith Lindsay wrote:
> Greetings,
> 
> In the Ferret Users Guide, theta_fo is documented as taking arguments as
> 
> THETA_FO( salt, temp, Z, Z_reference )
> 
> However, if you type 'show function theta_fo' into ferret V5, the order of
> arguments shows up as
> 
> THETA_FO(p,temp,salt,ref)
> 
> The source code of this function does not appear to be available. What is
> the proper order of arguments?
> 
> Thanks,
> Keith
> 
> ***********************************************************************
> Keith Lindsay                              phone: 303-497-1722
> Climate and Global Dynamics                fax:   303-497-1700