Pycraf

=======================

New Features
------------
pycraf.pathprof
^^^^^^^^^^^^^^
- Add an option to `pycraf.pathprof.height_map_data`, which allows to
retrieve longitude and latitude profiles to each pixel in a map. This
could, for example, be used for adding clutter heights along the paths.
[de42379]
- Add an option to return raw data from `pathprof.gis.regrid_from_geotiff`.
(May be needed for cases where proper normalisation is required.) [64]

Various
-------
- Migrate to Cython v3. [63]
- Use new package structure (`pyproject.toml`-only). [65]

=======================

New Features
------------
pycraf.pathprof
^^^^^^^^^^^^^^
- Add building entry loss model (Rec. ITU-R P.2109) [d9fd58]
- Allow numpy broadcasting for clutter-correction function [a2984e]
and improve its speed via OpenMP [414233]
- Add option to P.452 functions to change base water density of
atmosphere [57, 633c8c]

Documentation
-------------
- Improve the "conversions" Jupyter notebook [76ae97]

=======================

The new pycraf version 2 is mainly about a new packaging structure
(using pyproject.toml etc.). Furthermore, the graphical user interface
`pycraf-gui` was moved into a dedicated package. Not every users needs
the GUI, but it adds heavily to the package dependencies.

New Features
------------
pycraf.antenna
^^^^^^^^^^^^^^
- Add extended IMT composite array antenna (5G) model [b31fa7]

Bugfixes
~~~~~~~~~~
- Use new `pyproj.Transformer` class in `geospatial` sub-package. [953427]
- Use `functools.wraps` instead of the `astropy` `wraps`. This fixes `pycraf`
for use with `astropy` version 5. [683a06]
- Fix matplotlib error with `terrain_cmap` [71e284b]

=======================

New Features
------------
pycraf.antenna
^^^^^^^^^^^^^^
- Add average sectoral antenna pattern for fixed links according to Rec.
ITU-R F.1336-5. (The peak sectoral antenna patter was already included,
previously.) [7094f34]

pycraf.pathprof
^^^^^^^^^^^^^^^
- Add more of the 3GPP TR38.901 path propagation models for IMT (i.e., Urban/
Rural Macro). This is needed for applying power control algorithm related
to user equipment in 5G compatibility studies. [125b25b]

Bugfixes
~~~~~~~~~~
- Fix some bugs related to newer matplotlib version in various tutorial
notebooks [b55c014]

=======================

New Features
------------
pycraf.pathprof
^^^^^^^^^^^^^^^
- Add a `cache` option to `pathprof.height_map_data`, which is based on the
`joblib` Python package. With this, one can easily re-use existing height
data (`hprof_cache`) from a previous run to save computing time. [b86c7d]
- Add a `generic_heights` option to the several functions and the `PathProp`
class in the `pathprof` sub-package. With this, one case set terrain heights
to zero more conveniently. [a3e799]

Notes
-----
- As of Spring 2021, NASA decided to put all SRTM data products behind a
log-in page, such that automatic download ceases to work. For the time
being, the default server (and only server) in pycraf will thus be
`viewpano`. If you prefer to use NASA tiles (over `viewpano`), please use
their services, e.g., the Land Processes Distributed Active Archive Center.

Bugfixes
~~~~~~~~~~
- In some cases, but only when working with hgt tiles having a different
angular resolution than 3", terrain height interpolation was still based
on the 3" instead of the proper resolution. [89e0b0]
- There was a bug in the `geometry` sub-package, which caused all rotation
matrices be transposed (which is the same a applying a negative rotation
angle). We used the opportunity to also fix the sign of the `etilt` angle
in the `imt2020_composite_pattern`. [47e772,9fb8d6]

=======================

Bugfixes
~~~~~~~~~~
- Fix (stable) HTML manual
- Make satellite sub-package work with `sgp4 2.0+`