X-Git-Url: https://wylark.com/src/munter.git/blobdiff_plain/db3e8baef065f72426d268dfb00919049988b8f3..363bc8c5115d6714444d1660ab4c386b442deda2:/README.md?ds=sidebyside diff --git a/README.md b/README.md index a61f2d9..37c034c 100644 --- a/README.md +++ b/README.md @@ -13,17 +13,42 @@ estimates is your own fault. Installation ------------ -There is no installation and there are no dependencies external to the Python -standard library. +If you use pip, then simply `pip install munter.py`. + +If you don't use pip, then download the source code and unpack it into +its own directory. You can invoke it directly via `python munter.py +[options]`. How to use it ------------- +For detailed information, see: + `./munter.py --help` +The program supports both imperial and metric, and has four "travel +modes" at this time: uphill, flat, downhill, bushwhacking. It also +supports a simple fitness modifier: slow, average, fast. + +By default, the output will be the time in hours and minutes of the +specified leg. If you prefer, you can use the `-p` switch to get a +"prettier" output. + +### Use as a library + +You can also use Munter.py programmatically from Python, like so: + +`import munter` +`est = munter.time_calc(distance=3.2, elevation=2300, fitness='slow')` + +This will store a value like "3.64914" in the `est` variable. + +Workflow +-------- + My workflow involves planning my tour using tools like ArcGIS or CalTopo. Then, I take the stats between each leg (distance, vertical gain/loss) of the tour -and run them through Munter.py and thence record its output to my field +and run them through Munter.py and record its output to my field notebook. The rudimentary "GUI" can be directly transferred to e.g. the format used by @@ -33,21 +58,25 @@ SnowPit Technologies' "Avalanche Field Notebook" or your own personal format Future plans ------------ -* Personal "fitness" switch (to help fine tune your estimates based on - your personal fitness level as observed - over time) * GTK mode -* Use as a Python library from within another project * Lint it (e.g. therapist) -* Pip? * Sphinx/autodoc? Version History --------------- +- 2.1.0 (Jun 2020) + + Implement fitness modifier. Make some text changes and other + miscellaneous and minor improvements. + +- 2.0.1 (Jun 2020) + + README improvement. + - 2.0.0 (Jun 2020) - Packaged for distribution as a standalone program (and library). + Package for distribution as a standalone program (and library). - 1.0.2 (Jun 2020)