# Coordinates¶

The following introduces the concept of the
`coordinates`

class and the coorindate systems that
are available in pyfar.

## Coordinates Class¶

Different coordinate systems are frequently used in acoustics research and
handling sampling points and different systems can be cumbersome. The
`Coordinates class`

was
designed with this in mind. It can convert between coordinate systems and
rotate, query and plot coordinates points. Functions for converting coordinates
not stored in a `Coordinates`

object are
available for convenience. However, it is strongly recommended to
use the `Coordinates`

class for all
conversions.

## Coordinate Systems¶

Coordinate systems are defined by their domain (e.g. `'spherical'`

),
convention (e.g. `'top_elev'`

), and unit (e.g. `'deg'`

). The available
coordinate systems are shown in the image below

The unit for length is always meter, while the unit for angles can be radians and degrees.

A complete list of coordinate systems can also by obtained by

```
>>> coords = Coordinates() # get an empty instance of the class
>>> coords.systems() # list all systems
```

## Samplings¶

A plethora of sampling schemes to generate coordinate objects is contained in
`samplings`

.