fixed number density calculations
added angular units handling
updated examples and docs