Skip to content

Commit

Permalink
Updated README, demo notebook, version info (1.4) (#71)
Browse files Browse the repository at this point in the history 
* Removed executable portion of beta_functions.py

This section was never used and very out of date. Removing it.

* modified:   notebooks/CSU_RadarTools_Demo.ipynb

* modified:   notebooks/CSU_RadarTools_Demo.ipynb

* Rename test file to the proper, expected name

* Drop EoL Python 3.4 from active test matrix and add current 3.7

* Minor refactoring that *should* streamline installing the test environment.

* update demo notebook

* modified:   README.md
	modified:   csu_radartools/_version.py
	modified:   setup.py

---------

Co-authored-by: C.A.M. Gerlach <[email protected]>
  • Loading branch information
@tjlang @CAM-Gerlach
tjlang and CAM-Gerlach authored Oct 22, 2024
1 parent af6c7ed commit 3b2ca0e
Show file tree
Hide file tree
Showing 8 changed files with 416 additions and 282 deletions.
7 changes: 2 additions & 5 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Scalars and arrays are supported as function inputs. The main exception is `csu_

To install CSU_RadarTools, download the source code and then run the following in the code's home directory:

```python setup.py install```
```pip install .```

By default, if the `CSURT_F2PY` environment variable is not set (or set to a case-insensitive match for {`0`, `false`, `no`}, the package will be compiled using Cython to speed up KDP and other routines.
This enables the widest cross-platform support.
Expand All @@ -39,10 +39,7 @@ from csu_radartools import (csu_fhc, csu_liquid_ice_mass, csu_blended_rain,
For help information do help on individual modules.
There is also a demonstration IPython notebook in the notebooks directory that covers all the modules.

CSU_RadarTools is known to work under Python 2.7 and 3.4-3.7.
Other Python versions are untested.
Although we still fully support Python 2.7 at this time, we strongly recommend you move to Python >=3.6 as soon as practicable, given the Python 2 end of life date in less than a year, and the fact that many other scientific packages have dropped it already.
For more information, please see e.g. [the Python 3 Statement](https://python3statement.org/).
CSU_RadarTools is known to work under Python 3.X

Latest release of CSU_RadarTools (v1.3):
[![DOI](https://zenodo.org/badge/31606116.svg)](https://zenodo.org/badge/latestdoi/31606116)
Expand Down
2 changes: 1 addition & 1 deletion csu_radartools/_version.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@

"""Version File."""

VERSION_INFO = (1, 3, 0, 'dev0')
VERSION_INFO = (1, 4, 0, 'dev0')
__version__ = '.'.join(map(str, VERSION_INFO))
521 changes: 252 additions & 269 deletions notebooks/CSU_RadarTools_Demo.ipynb
View file

Large diffs are not rendered by default.

Binary file added notebooks/KAMX20130925_171241_V06.gz
View file
Binary file not shown.
Binary file added notebooks/cfrad.20040805_213003.000_to_20040805_214323.000_SPOL_v1_SUR.nc.gz
View file
Binary file not shown.
Binary file added notebooks/cfrad.20060119_170029.000_to_20060121_020810.000_CPOL_v1_PPI.nc.gz
View file
Binary file not shown.
160 changes: 160 additions & 0 deletions notebooks/snd_Darwin.txt
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,160 @@
94120 YPDN Darwin Airport Observations at 00Z 20 Jan 2006

-----------------------------------------------------------------------------
PRES HGHT TEMP DWPT RELH MIXR DRCT SKNT THTA THTE THTV
hPa m C C % g/kg deg knot K K K
-----------------------------------------------------------------------------
1004.0 30 25.2 21.9 82 16.79 130 10 298.0 346.9 301.0
1000.0 67 24.6 21.1 81 16.03 115 13 297.8 344.4 300.6
993.0 129 23.8 21.4 86 16.45 74 19 297.6 345.4 300.5
988.0 173 24.6 22.8 90 18.05 45 24 298.8 351.6 302.0
983.0 218 25.4 24.2 93 19.80 41 21 300.0 358.3 303.6
975.0 290 25.0 23.9 94 19.64 35 15 300.3 358.2 303.8
960.0 426 24.2 23.4 96 19.34 25 10 300.8 357.9 304.3
927.0 734 22.4 22.3 99 18.68 1 15 302.0 357.4 305.4
925.0 753 22.2 22.2 100 18.60 0 15 302.0 357.2 305.4
923.0 772 22.1 22.0 100 18.46 355 15 302.1 356.9 305.4
864.0 1346 19.0 17.3 90 14.58 0 12 304.6 348.3 307.2
850.0 1488 18.2 16.1 88 13.73 350 12 305.2 346.5 307.7
830.0 1692 16.9 15.4 91 13.46 325 16 305.9 346.5 308.3
800.0 2007 14.8 14.4 97 13.06 314 23 306.9 346.5 309.3
774.0 2286 13.5 12.8 96 12.18 305 29 308.4 345.6 310.7
721.0 2884 10.8 9.5 92 10.44 296 29 311.8 344.2 313.7
714.0 2966 11.0 9.2 89 10.32 295 29 312.8 345.0 314.8
706.0 3060 11.2 8.8 85 10.17 301 26 314.1 346.0 316.0
700.0 3132 10.8 8.9 88 10.33 305 23 314.4 346.8 316.4
696.0 3179 10.5 8.6 88 10.15 305 21 314.6 346.4 316.5
682.0 3347 9.3 7.4 88 9.54 295 19 315.1 345.2 316.9
645.0 3807 6.1 4.1 87 8.02 290 26 316.5 342.1 318.0
616.0 4186 3.4 1.4 87 6.92 293 34 317.6 339.9 318.9
609.0 4279 3.4 -0.5 76 6.10 294 37 318.6 338.4 319.8
601.0 4386 2.8 -0.7 78 6.08 295 39 319.1 338.9 320.3
573.0 4772 0.6 -1.5 86 6.02 303 29 321.0 340.7 322.1
559.0 4971 0.8 -2.6 78 5.69 307 23 323.5 342.4 324.6
530.0 5397 -1.9 -2.3 97 6.12 315 12 325.2 345.6 326.4
526.0 5458 -2.3 -2.3 100 6.18 307 12 325.4 346.0 326.6
504.0 5797 -3.6 -4.4 94 5.51 265 13 327.8 346.4 328.9
500.0 5860 -3.9 -4.8 93 5.39 265 14 328.2 346.5 329.3
472.0 6312 -6.5 -6.9 97 4.86 265 9 330.4 347.1 331.4
468.0 6378 -6.9 -7.2 98 4.79 275 9 330.8 347.2 331.7
463.0 6462 -7.3 -11.9 70 3.34 283 9 331.3 343.0 331.9
459.0 6529 -7.9 -12.1 72 3.31 290 10 331.3 343.0 332.0
456.0 6580 -7.6 -12.4 68 3.25 295 10 332.3 343.8 333.0
455.0 6597 -7.5 -12.5 67 3.24 295 10 332.7 344.1 333.3
448.0 6718 -7.9 -10.8 80 3.78 295 11 333.6 346.9 334.4
445.0 6770 -8.1 -10.0 86 4.04 289 10 334.0 348.2 334.9
443.0 6805 -7.5 -11.4 74 3.63 285 9 335.2 348.1 336.0
439.0 6875 -8.1 -13.1 67 3.19 276 8 335.3 346.7 336.0
422.0 7179 -10.1 -15.0 67 2.85 240 1 336.6 346.9 337.2
421.0 7197 -10.2 -15.1 67 2.83 0 0 336.7 346.9 337.3
400.0 7590 -12.7 -17.5 67 2.43 305 6 338.4 347.3 338.9
361.0 8367 -18.1 -19.9 86 2.20 154 11 341.2 349.4 341.7
354.0 8513 -19.0 -21.5 80 1.95 125 12 342.0 349.3 342.4
339.0 8836 -20.9 -25.0 70 1.49 125 18 343.6 349.3 343.9
338.0 8858 -20.5 -25.1 67 1.48 125 18 344.4 350.1 344.8
324.0 9167 -23.1 -28.1 63 1.17 115 19 345.1 349.7 345.4
300.0 9730 -27.7 -33.7 57 0.74 130 17 346.2 349.2 346.4
291.0 9948 -29.1 -37.1 46 0.55 133 18 347.3 349.5 347.4
255.0 10871 -37.1 -44.2 47 0.30 145 24 348.8 350.1 348.9
250.0 11010 -38.3 -45.3 48 0.27 145 24 349.0 350.1 349.0
224.0 11754 -45.1 -51.1 51 0.16 143 26 349.7 350.4 349.7
210.0 12182 -49.1 -57.1 39 0.08 141 27 349.9 350.3 350.0
200.0 12500 -51.5 -59.5 38 0.06 140 28 351.1 351.4 351.1
172.0 13461 -59.9 -69.9 26 0.02 130 34 352.6 352.7 352.6
150.0 14300 -67.5 120 40 353.6 353.6
143.0 14585 -70.0 125 38 354.2 354.2
131.0 15106 -74.5 116 38 355.1 355.1
130.0 15150 -74.8 115 38 355.4 355.4
122.0 15513 -76.9 95 45 357.9 357.9
100.0 16650 -83.7 85 35 365.8 365.8
90.0 17227 -86.7 105 39 371.0 371.0
85.0 17540 -88.3 100 51 373.9 373.9
76.1 18139 -87.3 88 58 387.9 387.9
74.0 18294 -80.7 85 60 404.9 404.9
70.0 18610 -76.5 85 51 420.4 420.4
69.5 18651 -76.1 86 49 422.1 422.1
67.5 18819 -76.9 89 42 423.9 423.9
64.0 19130 -71.2 95 29 442.9 442.9
63.7 19157 -70.7 96 28 444.6 444.6
63.0 19222 -71.1 100 24 445.2 445.2
60.0 19508 -72.6 120 24 448.0 448.0
56.0 19912 -74.9 110 18 451.8 451.8
54.9 20028 -75.5 109 21 452.9 452.9
50.0 20570 -74.3 105 35 468.0 468.0
45.0 21187 -73.0 105 36 485.5 485.5
41.3 21690 -71.9 99 55 500.2 500.2
39.0 22034 -67.6 95 67 519.3 519.3
37.0 22351 -63.7 98 68 537.2 537.2
36.0 22520 -63.1 100 68 543.0 543.0
32.9 23076 -61.1 92 70 562.5 562.5
32.0 23248 -60.8 90 71 567.8 567.8
30.0 23650 -60.1 75 67 580.2 580.2
28.0 24081 -59.6 75 73 593.2 593.2
27.7 24149 -59.5 75 73 595.3 595.3
27.6 24172 -59.4 75 73 596.2 596.2
24.0 25058 -55.1 75 55 632.8 632.8
23.2 25273 -54.1 87 51 642.0 642.0
22.0 25612 -55.4 105 45 647.9 647.9
20.9 25940 -56.7 105 47 653.6 653.6
20.0 26220 -55.1 105 49 666.8 666.8
18.4 26759 -50.3 85 58 697.9 697.9
18.0 26902 -50.6 80 60 701.4 701.4
17.0 27274 -51.3 80 49 710.6 710.6
16.4 27509 -48.7 80 43 726.4 726.4
16.0 27671 -48.8 80 38 731.1 731.1
15.3 27965 -49.1 104 31 739.6 739.6
15.0 28096 -46.9 115 28 751.2 751.2
14.9 28140 -46.1 115 29 755.2 755.2
13.6 28748 -45.5 112 46 777.2 777.2
13.0 29047 -46.2 110 54 784.9 784.9
12.0 29576 -47.4 70 30 798.8 798.8
11.0 30152 -48.7 80 19 814.0 814.0
10.6 30397 -49.3 74 29 820.6 820.6
10.3 30589 -40.9 70 36 858.5 858.5
10.2 30655 -40.5 68 39 862.3 862.3
10.0 30790 -40.9 65 44 865.7 865.7
9.0 31499 -44.2 65 38 879.3 879.3
8.6 31805 -45.7 71 41 885.2 885.2
8.5 31883 -45.9 72 42 887.4 887.4
8.2 32125 -40.3 77 45 918.6 918.6
8.0 32293 -40.5 80 47 924.1 924.1
7.3 32916 -41.5 101 39 944.7 944.7
7.0 110 36
Station information and sounding indices

Station identifier: YPDN
Station number: 94120
Observation time: 060120/0000
Station latitude: -12.41
Station longitude: 130.88
Station elevation: 30.0
Showalter index: 0.45
Lifted index: -2.25
LIFT computed using virtual temperature: -2.49
SWEAT index: 231.21
K index: 36.30
Cross totals index: 20.00
Vertical totals index: 22.10
Totals totals index: 42.10
Convective Available Potential Energy: 774.41
CAPE using virtual temperature: 876.16
Convective Inhibition: -12.17
CINS using virtual temperature: -12.64
Equilibrum Level: 145.57
Equilibrum Level using virtual temperature: 145.50
Level of Free Convection: 877.13
LFCT using virtual temperature: 887.61
Bulk Richardson Number: 11.10
Bulk Richardson Number using CAPV: 12.56
Temp [K] of the Lifted Condensation Level: 295.81
Pres [hPa] of the Lifted Condensation Level: 955.36
Mean mixed layer potential temperature: 299.71
Mean mixed layer mixing ratio: 18.58
1000 hPa to 500 hPa thickness: 5793.00
Precipitable water [mm] for entire sounding: 66.21
Description of the data columns or sounding indices.


Interested in graduate studies in atmospheric science? Check out our program at the University of Wyoming
Questions about the weather data provided by this site can be addressed to Larry Oolman ([email protected])

8 changes: 1 addition & 7 deletions setup.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -98,19 +98,13 @@ def get_version(module=None):
'Operating System :: POSIX :: Linux',
'Operating System :: Unix',
'Programming Language :: Cython',
'Programming Language :: Python :: 2',
'Programming Language :: Python :: 2.7',
'Programming Language :: Python :: 3',
'Programming Language :: Python :: 3.4',
'Programming Language :: Python :: 3.5',
'Programming Language :: Python :: 3.6',
'Programming Language :: Python :: 3.7',
'Topic :: Scientific/Engineering :: Atmospheric Science',
],
packages=PACKAGES,
package_data={'csu_radartools': ['beta_function_parameters/*.csv']},
ext_modules=EXTENSIONS,
include_dirs=INCLUDE_DIRS,
install_requires=['numpy', 'pandas', 'matplotlib', 'scipy', 'cython', 'netCDF4'],
python_requires='>=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4',
python_requires='<4',
)

0 comments on commit 3b2ca0e

Please sign in to comment.