Skip to content

Commit c2ede5c

Browse files
committed
Updated docs
1 parent d6117f5 commit c2ede5c

File tree

2 files changed

+212
-202
lines changed

2 files changed

+212
-202
lines changed

README.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,29 @@
1-
2-
**Python 3+**, current release: **1.0.0** build 2022-07-21
1+
Release: **1.0.1** | build: **2024.08.26** | Python: **>=3.7**
32

43
# Python Lanchester's laws
54

6-
**A Python module, a Jupyter notebook and a sample application for predicting the result of a battle using Lanchester differential equations. The module can predict the result with 3 different models: `linear law`, `square law` and `modernized model`. An example included in the repository allows you to predict the result using one of these 3 models and display the result and a plot with the progress of the battle over time. The module can be easily used in any Python application.**
5+
**A Python module, Jupyter notebook, and sample application for predicting the outcome of battles using Lanchester's differential equations. The module can forecast results using three different models: the `linear law`, the `square law`, and a `modernized model`. An example included in the repository demonstrates how to predict outcomes using any of these three models and display both the result and a plot showing the progress of the battle over time. The module can be easily integrated into any Python application.**
76

87
## What are Lanchester's laws?
8+
99
from: https://en.wikipedia.org/wiki/Lanchester%27s_laws
1010
> Lanchester's laws are mathematical formulae for calculating the relative strengths of military forces. The Lanchester equations are differential equations describing the time dependence of two armies' strengths A and B as a function of time, with the function depending only on A and B.
1111
In 1915 and 1916, during World War I, M. Osipov and Frederick Lanchester independently devised a series of differential equations to demonstrate the power relationships between opposing forces. Among these are what is known as Lanchester's linear law (for ancient combat) and Lanchester's square law (for modern combat with long-range weapons such as firearms).
1212

13-
**Screenshot from included example application:**
13+
**Screenshot from included example application**
1414

1515
![lanchester](https://user-images.githubusercontent.com/61396542/180256468-4fec137e-121a-416b-86ce-ed96f4a27ad2.png)
1616

17-
## Repository contents:
17+
## Repository contents
1818

19-
- `lanchester.py` - Python module with functions that solve the Lanchester equations in time
20-
- `app.py` - example application that uses the module
21-
- `notebook.ipynb` - Jupyter notebook with an example of how it works in real-time
19+
- `lanchester.py` - A Python module containing functions that solve the Lanchester equations over time.
20+
- `app.py` - An example application demonstrating the use of the module.
21+
- `notebook.ipynb` - A Jupyter notebook showcasing an example of how the module works in real time.
2222

2323

24-
### Example of use:
24+
### Example of Use
2525

26-
The module can predict the result using 3 different models: `linear law`, `square law` and `modernized model`.
26+
The module can predict outcomes using three different models: the `linear law`, the `square law`, and a `modernized model`.
2727

2828
**Required packages**
2929

@@ -145,13 +145,16 @@ plt.legend()
145145
plt.show()
146146
```
147147

148-
**Result:**
148+
**Result of the battle**
149149

150150
![lanchester](https://user-images.githubusercontent.com/61396542/180256468-4fec137e-121a-416b-86ce-ed96f4a27ad2.png)
151151

152152

153153
## Changelog
154-
**- 1.0.0** - published first release (2022-07-21)
154+
155+
**1.0.0** - Initial release (2022-07-21)
156+
157+
**1.0.1** - Updated documentation (2024-08-26)
155158

156159
---
157160
**Python Lanchester is free to use, but if you like it, you can support my work by buying me a coffee ;)**

0 commit comments

Comments
 (0)