The electronic structure of rare-earth metals and alloys, the magnetic heavy rare-earths