Skip to main content

Python extension of wows_shell

Project description

wows_shell

License GitHub commit activity Discord

  • C++ header only library for calculating shell performance in World of Warships
  • Experimentally verified to be nearly identical to the World of Warships ballistics model

Legal

  • All copyrighted material provided by Wargaming.net are owned by Wargaming.net.
  • All other material is available under the MIT License.

Original Model Information & Source Code:

Original Model:

Revised Model:

Features:

Shell Flight

Computes shell flight path.

At Impact:

Outputs:

  • Angle of Impact
  • Impact Velocity
  • Raw, Belt/Deck, Normalization Adjusted Penetration
  • Shell flight time (Real / In-game)

Ability to change trajectory computation method

  • Forward Euler (default - also in-game method)
  • Runge-Kutta 2 and 4
  • Adams-Bashforth 5

Lateral Angles:

Computes lateral angles where penetration, AP fuzing, and ricochets occur while adjusting for impact angle and vertical armor inclination.

Definition: Angles where that represent the horizontal angling of a ship:

  • Bow-in: 90 degrees
  • Full-broadside: 0 degrees

Outputs:

  • Maximum Lateral Angle for Penetration
  • Minimum Lateral Angle for Fusing
  • Ricochet Lateral Angles

Dispersion

Computes dispersion approximations based on experimental data.
Outputs:

  • Dispersion Types:
    • Horizontal Dispersion
    • Vertical Dispersion
    • Area Dispersion
  • Statistical Types
    • Max Dispersion
    • Standard Deviation of Dispersion
    • 50% Error Radius

Post-Penetration:

Shell detonation distance after penetration while adjusting for ship angling, and vertical armor inclinations.

Ability to modify the way the calculations are done

  • Enable or Disable Normalization changing direction
  • Linear estimation or full air drag modeling

Fitting:

Capability to fit shells to real world data using gradient descent.

  • Air Drag Coefficient
  • Krupp

Compatibility:

  • Requires C++17 supporting compiler
  • Supports multithreading and vectorization for improved performance

Extensions:

Python

  • Requires Pybind11
  • Tested with Python 3.7.4 (Anaconda), 3.8.5
  • Available from PyPI pip install wows-shell

WebAssembly

Future Goals:

  • Wiki / Tutorial
  • Extend more features to Python and WebAssembly
  • Will continue to update the model when new information is acquired

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wows_shell-1.1.5.tar.gz (276.2 kB view details)

Uploaded Source

Built Distribution

wows_shell-1.1.5-cp38-cp38-win_amd64.whl (141.6 kB view details)

Uploaded CPython 3.8 Windows x86-64

File details

Details for the file wows_shell-1.1.5.tar.gz.

File metadata

  • Download URL: wows_shell-1.1.5.tar.gz
  • Upload date:
  • Size: 276.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.55.0 CPython/3.8.5

File hashes

Hashes for wows_shell-1.1.5.tar.gz
Algorithm Hash digest
SHA256 d4192d42fcbf4b8139f8127a0b60da67747a1e6eb98811651914083c7bd2298f
MD5 1b3d8690a136086c6de7ba3dcbf39e28
BLAKE2b-256 ee2fba833bd1adb8393b7e76a56508d495839999b6b1b10e766c8bb6fd6382cb

See more details on using hashes here.

File details

Details for the file wows_shell-1.1.5-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: wows_shell-1.1.5-cp38-cp38-win_amd64.whl
  • Upload date:
  • Size: 141.6 kB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.55.0 CPython/3.8.5

File hashes

Hashes for wows_shell-1.1.5-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 5a105ccdee3ac06b19c0fdb1e1e1508f602412e1953bb0f5c51af81f4ae4eb4c
MD5 71a27e53c922e4a296a8dfbd15a391d3
BLAKE2b-256 04b2fac73b371fad306e0ae76cbcb0f5a4137993b140270548382353b77dcbc3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page