New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Doc tweaks #326
Doc tweaks #326
Conversation
Not the most elegant, but it does get the class methods documented. Thoughts @dopplershift? |
I think we can safely ignore codecov here since it's griping about the references? |
Can you rebase and push? I'm concerned about the drop in coverage in the tests themselves. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mostly just minor, adding the page numbers for the Hobbs 1977 references.
metpy/calc/basic.py
Outdated
@@ -242,7 +224,7 @@ def heat_index(temperature, rh, mask_undefined=True): | |||
def pressure_to_height_std(pressure): | |||
r"""Convert pressure data to heights using the U.S. standard atmosphere. | |||
|
|||
The implementation uses the formula outlined in [7]_. | |||
The implementation uses the formula outlined in [Hobbs1977]_. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you add the pages here?
metpy/calc/basic.py
Outdated
@@ -273,7 +250,7 @@ def pressure_to_height_std(pressure): | |||
def coriolis_parameter(latitude): | |||
r"""Calculate the coriolis parameter at each point. | |||
|
|||
The implementation uses the formula outlined in [8]_. | |||
The implementation uses the formula outlined in [Hobbs1977]_. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Here too.
metpy/calc/thermo.py
Outdated
@@ -339,15 +334,10 @@ def vapor_pressure(pressure, mixing): | |||
Notes | |||
----- | |||
This function is a straightforward implementation of the equation given in many places, | |||
such as [2]_: | |||
such as [Hobbs1977]_: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Again.
metpy/calc/thermo.py
Outdated
@@ -478,15 +460,10 @@ def mixing_ratio(part_press, tot_press, molecular_weight_ratio=epsilon): | |||
Notes | |||
----- | |||
This function is a straightforward implementation of the equation given in many places, | |||
such as [5]_: | |||
such as [Hobbs1977]_: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One more.
metpy/calc/thermo.py
Outdated
@@ -499,7 +476,7 @@ def saturation_mixing_ratio(tot_press, temperature): | |||
r"""Calculate the saturation mixing ratio of water vapor. | |||
|
|||
This calculation is given total pressure and the temperature. The implementation | |||
uses the formula outlined in [6]_. | |||
uses the formula outlined in [Hobbs1977]_. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
And here.
metpy/calc/thermo.py
Outdated
@@ -526,7 +498,7 @@ def equivalent_potential_temperature(pressure, temperature): | |||
r"""Calculate equivalent potential temperature. | |||
|
|||
This calculation must be given an air parcel's pressure and temperature. | |||
The implementation uses the formula outlined in [7]_. | |||
The implementation uses the formula outlined in [Hobbs1977]_. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Again.
Really? hmm. I rendered with RTD and didn't see that, but I'll change it up and see if I can reproduce. |
Works for me if I add |
Modified the aspect ratio a bit - should be good to go. |
Improvements on documentation including references and method documentation. Addresses #314