works in pricniple but way too complicated..

Add boilerplate "filter" function.

Change some function privacy settings.

Fix some doc errors.

Add splitting ratio to Beamsplitter (not used yet).