add main methods to filters; update readme with usage instructions