update core and aggregate procesor docs, refactor core.py