# OpenTire/OpenTire

An open-source mathematical tire modelling library
Python
ho1 Correction to B_r calculation
`Changed * to + sign before QBZ10`
Latest commit d2aad3b May 4, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
code May 4, 2017
examples Apr 8, 2017
.gitignore

# OpenTIRE - The open-source mathematical tire modelling library

The OpenTire project is a non-commercial project that has three primary goals:

• Provide a library of open-source tire models in an easily accessible and useable format
• Provide a technical platform for collaborative tire model development
• Build a library of tire data and tire models available for use in research projects

## Background

The complexity involved in simulating tires can make it difficult to implement tire models in research and development studies. Firstly, turning equations in literature into software code can be a daunting task. Testing and validating an implementation is difficult and time consuming. Secondly, without a single open-source implementation of tire models collaborative development of tire models are difficult and slow. Lastly, getting access to tire data and tire models without large investments in testing is very difficult. As a result a significant part of tire and vehicle dynamics research is carried out using a tire model for 205/60R15 tire, which is readily available in literature.

## Getting Started

If you are unfamiliar with packages and modules in Python, the first thing you'll have to do before using OpenTire is to install the package with your Python installation. To help with this, OpenTire comes with a setup scripts that automates it all. To install it, run the setup.py script with install as an argument.

`setup.py install`

Once OpenTire is installed, you can load up a tire model with these commands:

```from opentire import OpenTire
from opentire.Core import TireState

openTire = OpenTire()
myTireModel = openTire.createmodel('PAC2002')

state = TireState()
state['FZ'] = 1500
state['IA'] = 0.0
state['SR'] = 0.0
state['SA'] = 0.0
state['FY'] = 0.0
state['V'] = 10.0
state['P'] = 260000

myTireModel.solve(state)```

For more comprehensive examples, please check out the additional examples in the examples folder.

## Examples

To help you get started using OpenTire, there are a number of different Jupyter Notebooks which demonstrates how to initiate OpenTire and how to integrate into a tire or vehicle simulation.