added extract_filtered function
docs