{ "cells": [ { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "xkcd 1313: Regex Golf (Part 2: Infinite Problems)\n", "====\n", "\n", "

Peter Norvig
with Stefan Pochmann
Feb 2014
revised Nov 2015

\n", "\n", "\n", "\n", "\n", "\n", "This Again?\n", "----\n", "\n", "Last month I demonstrated [a simple Regex Golf program](http://nbviewer.ipython.org/url/norvig.com/ipython/xkcd1313.ipynb?create=1). I thought that was the end of the topic, but [Stefan Pochmann](http://www.stefan-pochmann.info/spocc/) sent me a series of emails suggesting some impressive improvements. ([Davide Canton](https://plus.sandbox.google.com/108324296451294887432/posts) and [Thomas Breuel](https://plus.google.com/118190679520611168174/posts) also had good suggestions.) So this post is an exploration of some of Stefan's new ideas, and some of my own. It's a story about regex golf, and about using exploratory programming to test out ideas.\n", "\n", "To review, here's the program from [part 1](http://nbviewer.ipython.org/url/norvig.com/ipython/xkcd1313.ipynb?create=1), with some minor modifications:" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "button": false, "collapsed": true, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "%matplotlib inline\n", "import matplotlib\n", "import numpy as np\n", "import matplotlib.pyplot as plt\n", "\n", "from __future__ import division, print_function" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "from collections import Counter, defaultdict\n", "import re\n", "import itertools\n", "import random \n", "\n", "Set = frozenset # Data will be frozensets, so they can't be mutated.\n", "\n", "def words(text):\n", " \"All space-separated words in text.\"\n", " return Set(text.split())\n", "\n", "def phrases(text, sep='/'): \n", " \"All sep-separated phrases in text, uppercased and stripped.\"\n", " return Set(p.upper().strip() for p in text.split(sep))\n", "\n", "def mistakes(regex, winners, losers):\n", " \"The set of mistakes made by this regex in classifying winners and losers.\"\n", " return ({\"Should have matched: \" + W \n", " for W in winners if not re.search(regex, W)} |\n", " {\"Should not have matched: \" + L \n", " for L in losers if re.search(regex, L)})\n", "\n", "def findregex(winners, losers, k=4):\n", " \"Find a regex that matches all winners but no losers (sets of strings).\"\n", " # Make a pool of regex parts, then pick from them to cover winners.\n", " # On each iteration, add the 'best' part to 'solution',\n", " # remove winners covered by best, and keep in 'pool' only parts\n", " # that still match some winner.\n", " pool = regex_parts(winners, losers)\n", " solution = []\n", " def score(p): return k * len(matches(p, winners)) - len(p)\n", " while winners:\n", " best = max(pool, key=score)\n", " solution.append(best)\n", " winners = winners - matches(best, winners)\n", " pool = {p for p in pool if matches(p, winners)}\n", " return OR(solution)\n", "\n", "def matches(regex, strings):\n", " \"Return a set of all the strings that are matched by regex.\"\n", " return {s for s in strings if re.search(regex, s)}\n", "\n", "OR = '|'.join # Join a sequence of strings with '|' between them\n", "cat = ''.join # Join a sequence of strings with nothing between them\n", "\n", "def regex_parts(winners, losers):\n", " \"Return parts that match at least one winner, but no loser.\"\n", " wholes = {'^' + w + '$' for w in winners}\n", " parts = {d for w in wholes for p in subparts(w) for d in dotify(p)}\n", " return wholes | {p for p in parts if not matches(p, losers)}\n", "\n", "def subparts(word):\n", " \"Return a set of subparts of word: consecutive characters up to length 4.\"\n", " return set(word[i:i+n] for i in range(len(word)) for n in (1, 2, 3, 4)) \n", " \n", "def dotify(part):\n", " \"Return all ways to replace a subset of chars in part with '.'.\"\n", " choices = map(replacements, part)\n", " return {cat(chars) for chars in itertools.product(*choices)}\n", "\n", "def replacements(c): \n", " \"All ways to replace character c with something interesting: for now, 'c' or '.'.\"\n", " return c if c in '^$' else c + '.'\n", "\n", "def report(winners, losers):\n", " \"Find a regex to match A but not B, and vice-versa. Print summary.\"\n", " solution = findregex(winners, losers)\n", " assert not mistakes(solution, winners, losers)\n", " print('Chars: {}, ratio: {:.1f}, inputs: {}:{}'.format(\n", " len(solution), len(trivial(winners)) / len(solution) , len(winners), len(losers)))\n", " return solution\n", "\n", "def trivial(winners): return '^(' + OR(winners) + ')$'" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Here are some \"arbitrary lists\" (see panel two of the comic) which we will be using to test out the code. " ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "winners = words('''washington adams jefferson jefferson madison madison monroe \n", " monroe adams jackson jackson van-buren harrison polk taylor pierce buchanan \n", " lincoln lincoln grant grant hayes garfield cleveland harrison cleveland mckinley\n", " mckinley roosevelt taft wilson wilson harding coolidge hoover roosevelt \n", " roosevelt roosevelt roosevelt truman eisenhower eisenhower kennedy johnson nixon \n", " nixon carter reagan reagan bush clinton clinton bush bush obama obama''')\n", "losers = words('''clinton jefferson adams pinckney pinckney clinton king adams \n", " jackson adams clay van-buren van-buren clay cass scott fremont breckinridge \n", " mcclellan seymour greeley tilden hancock blaine cleveland harrison bryan bryan \n", " parker bryan roosevelt hughes cox davis smith hoover landon wilkie dewey dewey \n", " stevenson stevenson nixon goldwater humphrey mcgovern ford carter mondale \n", " dukakis bush dole gore kerry mccain romney''') - winners\n", "\n", "boys = words('jacob mason ethan noah william liam jayden michael alexander aiden')\n", "girls = words('sophia emma isabella olivia ava emily abigail mia madison elizabeth')\n", "\n", "pharma = words('lipitor nexium plavix advair ablify seroquel singulair crestor actos epogen')\n", "cities = words('paris trinidad capetown riga zurich shanghai vancouver chicago adelaide auckland')\n", "\n", "foo = words('''afoot catfoot dogfoot fanfoot foody foolery foolish fooster footage foothot footle footpad footway \n", " hotfoot jawfoot mafoo nonfood padfoot prefool sfoot unfool''')\n", "bar = words('''Atlas Aymoro Iberic Mahran Ormazd Silipan altared chandoo crenel crooked fardo folksy forest \n", " hebamic idgah manlike marly palazzi sixfold tarrock unfold''')\n", "\n", "nouns = words('''time year people way day man thing woman life child world school \n", " state family student group country problem hand part place case week company \n", " system program question work government number night point home water room \n", " mother area money story fact month lot right study book eye job word business \n", " issue side kind head house service friend father power hour game line end member \n", " law car city community name president team minute idea kid body information \n", " back parent face others level office door health person art war history party result \n", " change morning reason research girl guy moment air teacher force education''')\n", "adverbs = words('''all particularly just less indeed over soon course still yet before \n", " certainly how actually better to finally pretty then around very early nearly now \n", " always either where right often hard back home best out even away enough probably \n", " ever recently never however here quite alone both about ok ahead of usually already \n", " suddenly down simply long directly little fast there only least quickly much forward \n", " today more on exactly else up sometimes eventually almost thus tonight as in close \n", " clearly again no perhaps that when also instead really most why ago off \n", " especially maybe later well together rather so far once''') - nouns \n", "verbs = words('''ask believe borrow break bring buy can be able cancel change clean\n", " comb complain cough count cut dance draw drink drive eat explain fall\n", " fill find finish fit fix fly forget give go have hear hurt know learn\n", " leave listen live look lose make do need open close shut organise pay\n", " play put rain read reply run say see sell send sign sing sit sleep\n", " smoke speak spell spend stand start begin study succeed swim take talk\n", " teach tell think translate travel try turn off turn on type understand\n", " use wait wake up want watch work worry write''') - nouns\n", "\n", "randoms = Set(vars(random))\n", "builtins = Set(vars(__builtin__)) - randoms\n", "\n", "starwars = phrases('''The Phantom Menace / Attack of the Clones / Revenge of the Sith /\n", " A New Hope / The Empire Strikes Back / Return of the Jedi''')\n", "startrek = phrases('''The Wrath of Khan / The Search for Spock / The Voyage Home /\n", " The Final Frontier / The Undiscovered Country / Generations / First Contact /\n", " Insurrection / Nemesis''')\n", "\n", "dogs = phrases(''''Labrador Retrievers / German Shepherd Dogs / Golden Retrievers / Beagles / Bulldogs / \n", " Yorkshire Terriers / Boxers / Poodles / Rottweilers / Dachshunds / Shih Tzu / Doberman Pinschers / \n", " Miniature Schnauzers / French Bulldogs / German Shorthaired Pointers / Siberian Huskies / Great Danes / \n", " Chihuahuas / Pomeranians / Cavalier King Charles Spaniels / Shetland Sheepdogs / Australian Shepherds / \n", " Boston Terriers / Pembroke Welsh Corgis / Maltese / Mastiffs / Cocker Spaniels / Havanese / \n", " English Springer Spaniels / Pugs / Brittanys / Weimaraners / Bernese Mountain Dogs / Vizslas / Collies / \n", " West Highland White Terriers / Papillons / Bichons Frises / Bullmastiffs / Basset Hounds / \n", " Rhodesian Ridgebacks / Newfoundlands / Russell Terriers / Border Collies / Akitas / \n", " Chesapeake Bay Retrievers / Miniature Pinschers / Bloodhounds / St. Bernards / Shiba Inu / Bull Terriers / \n", " Chinese Shar-Pei / Soft Coated Wheaten Terriers / Airedale Terriers / Portuguese Water Dogs / Whippets / \n", " Alaskan Malamutes / Scottish Terriers / Australian Cattle Dogs / Cane Corso / Lhasa Apsos / \n", " Chinese Crested / Cairn Terriers / English Cocker Spaniels / Dalmatians / Italian Greyhounds / \n", " Dogues de Bordeaux / Samoyeds / Chow Chows / German Wirehaired Pointers / Belgian Malinois / \n", " Great Pyrenees / Pekingese / Irish Setters / Cardigan Welsh Corgis / Staffordshire Bull Terriers / \n", " Irish Wolfhounds / Old English Sheepdogs / American Staffordshire Terriers / Bouviers des Flandres / \n", " Greater Swiss Mountain Dogs / Japanese Chin / Tibetan Terriers / Brussels Griffons / \n", " Wirehaired Pointing Griffons / Border Terriers / English Setters / Basenjis / Standard Schnauzers / \n", " Silky Terriers / Flat-Coated Retrievers / Norwich Terriers / Afghan Hounds / Giant Schnauzers / Borzois / \n", " Wire Fox Terriers / Parson Russell Terriers / Schipperkes / Gordon Setters / Treeing Walker Coonhounds''')\n", "cats = phrases('''Abyssinian / Aegean cat / Australian Mist / American Curl / American Bobtail / \n", " American Polydactyl / American Shorthair / American Wirehair / Arabian Mau / Asian / Asian Semi-longhair / \n", " Balinese / Bambino / Bengal / Birman / Bombay / Brazilian Shorthair / British Shorthair / British Longhair / \n", " Burmese / Burmilla / California Spangled Cat / Chantilly/Tiffany / Chartreux / Chausie / Cheetoh / \n", " Colorpoint Shorthair / Cornish Rex / Cymric / Cyprus cat / Devon Rex / Donskoy or Don Sphynx / Dragon Li / \n", " Dwelf / Egyptian Mau / European Shorthair / Exotic Shorthair / German Rex / Havana Brown / Highlander / \n", " Himalayan-Colorpoint Persian / Japanese Bobtail / Javanese / Khao Manee / Korat / Korn Ja / \n", " Kurilian Bobtail / LaPerm / Maine Coon / Manx / Mekong bobtail / Minskin / Munchkin / Nebelung / Napoleon / \n", " Norwegian Forest Cat / Ocicat / Ojos Azules / Oregon Rex / Oriental Bicolor / Oriental Shorthair / \n", " Oriental Longhair / Persian / Peterbald / Pixie-bob / Ragamuffin / Ragdoll / Russian Blue / Russian Black / \n", " Sam Sawet / Savannah / Scottish Fold / Selkirk Rex / Serengeti cat / Serrade petit / Siamese / Siberian / \n", " Singapura / Snowshoe / Sokoke / Somali / Sphynx / Swedish forest cat / Thai / Tonkinese / Toyger / \n", " Turkish Angora / Turkish Van / Ukrainian Levkoy / York Chocolate Cat''')\n", "\n", "movies = phrases('''Citizen Kane / The Godfather / Vertigo / 2001: A Space Odyssey / The Searchers / Sunrise / \n", " Singin’ in the Rain / Psycho / Casablanca / The Godfather Part II / The Magnificent Ambersons / Chinatown / \n", " North by Northwest / Nashville / The Best Years of Our Lives / McCabe & Mrs Miller / The Gold Rush / \n", " City Lights / Taxi Driver / Goodfellas / Mulholland Drive / Greed / Annie Hall / The Apartment / \n", " Do the Right Thing / Killer of Sheep / Barry Lyndon / Pulp Fiction / Raging Bull / Some Like It Hot / \n", " A Woman Under the Influence / The Lady Eve / The Conversation / The Wizard of Oz / Double Indemnity / \n", " Star Wars / Imitation of Life / Jaws / The Birth of a Nation / Meshes of the Afternoon / Rio Bravo / \n", " Dr Strangelove / Letter from an Unknown Woman / Sherlock Jr / The Man Who Shot Liberty Valance / \n", " It’s a Wonderful Life / Marnie / A Place in the Sun / Days of Heaven / His Girl Friday / Touch of Evil / \n", " The Wild Bunch / Grey Gardens / Sunset Boulevard / The Graduate / Back to the Future / Crimes and Misdemeanors / \n", " The Shop Around the Corner / One Flew Over the Cuckoo’s Nest / Blue Velvet / Eyes Wide Shut / The Shining / \n", " Love Streams / Johnny Guitar / The Right Stuff / Red River / Modern Times / Notorious / Koyaanisqatsi / \n", " The Band Wagon / Groundhog Day / The Shanghai Gesture / Network / Forrest Gump / \n", " Close Encounters of the Third Kind / The Empire Strikes Back / Stagecoach / Schindler’s List / \n", " The Tree of Life / Meet Me in St Louis / Thelma & Louise / Raiders of the Lost Ark / Bringing Up Baby / \n", " Deliverance / Night of the Living Dead / The Lion King / Eternal Sunshine of the Spotless Mind / \n", " West Side Story / In a Lonely Place / Apocalypse Now / ET: The Extra-Terrestrial / The Night of the Hunter / \n", " Mean Streets / 25th Hour / Duck Soup / The Dark Knight / Gone With the Wind / Heaven’s Gate / 12 Years a Slave / \n", " Ace in the Hole''')\n", "tv = phrases('''The Abbott and Costello Show / ABC’s Wide World of Sports / Alfred Hitchcock Presents /\n", " All in the Family / An American Family / American Idol / Arrested Development / Battlestar Galactica /\n", " The Beavis and Butt-Head Show / The Bob Newhart Show / Brideshead Revisited / Buffalo Bill /\n", " Buffy the Vampire Slayer / The Carol Burnett Show / The CBS Evening News with Walter Cronkite /\n", " A Charlie Brown Christmas / Cheers / The Cosby Show / The Daily Show / Dallas / The Day After / \n", " Deadwood / The Dick Van Dyke Show / Dragnet / The Ed Sullivan Show / The Ernie Kovacs Show /\n", " Felicity / Freaks and Geeks / The French Chef / Friends / General Hospital /\n", " The George Burns and Gracie Allen Show / Gilmore Girls / Gunsmoke / Hill Street Blues /\n", " Homicide: Life on the Street / The Honeymooners / I, Claudius / I Love Lucy / King of the Hill /\n", " The Larry Sanders Show / Late Night with David Letterman / Leave It to Beaver / Lost /\n", " Married with Children / Mary Hartman, Mary Hartman / The Mary Tyler Moore Show / MASH / The Monkees /\n", " Monty Python’s Flying Circus / Moonlighting / My So-Called Life / Mystery Science Theater 3000 /\n", " The Odd Couple / The Office / The Oprah Winfrey Show / Pee Wee’s Playhouse / Playhouse 90 /\n", " The Price Is Right / Prime Suspect / The Prisoner / The Real World / Rocky and His Friends / Roots /\n", " Roseanne / Sanford and Son / Saturday Night Live / Second City Television / See It Now / Seinfeld /\n", " Sesame Street / Sex and the City / The Shield / The Simpsons / The Singing Detective / Six Feet Under /\n", " 60 Minutes / Soap / The Sopranos / South Park / SpongeBob SquarePants / SportsCenter / Star Trek /\n", " St Elsewhere / The Super Bowl / Survivor / Taxi /The Tonight Show Starring Johnny Carson /\n", " 24 / The Twilight Zone / Twin Peaks / The West Wing / What’s My Line / WKRP in Cincinnati /\n", " The Wire / Wiseguy / The X-Files''')\n", "\n", "stars = phrases('''Humphrey Bogart / Cary Grant / James Stewart / Marlon Brando / Fred Astaire / Henry Fonda / \n", " Clark Gable / James Cagney / Spencer Tracy / Charlie Chaplin / Gary Cooper / Gregory Peck / John Wayne / \n", " Laurence Olivier / Gene Kelly / Orson Welles / Kirk Douglas / James Dean / Burt Lancaster / Marx Brothers / \n", " Buster Keaton / Sidney Poitier / Robert Mitchum / Edward G. Robinson / William Holden / Katharine Hepburn / \n", " Bette Davis / Audrey Hepburn / Ingrid Bergman / Greta Garbo / Marilyn Monroe / Elizabeth Taylor / Judy Garland / \n", " Marlene Dietrich / Joan Crawford / Barbara Stanwyck / Claudette Colbert / Grace Kelly / Ginger Rogers / \n", " Mae West / Vivien Leigh / Lillian Gish / Shirley Temple / Rita Hayworth / Lauren Bacall / Sophia Loren / \n", " Jean Harlow / Carole Lombard / Mary Pickford / Ava Gardner''')\n", "scientists = phrases('''Alain Aspect / Martin Karplus / David Baltimore / Donald Knuth / Allen Bard / \n", " Robert Marks II / Timothy Berners-Lee / Craig Mello / John Tyler Bonner / Luc Montagnier / Dennis Bray / \n", " Gordon Moore / Sydney Brenner / Kary Mullis / Pierre Chambon / C Nüsslein-Volhard / Simon Conway Morris / \n", " Seiji Ogawa / Mildred Dresselhaus / Jeremiah Ostriker / Gerald M Edelman / Roger Penrose / Ronald Evans / \n", " Stanley Prusiner / Anthony Fauci / Henry F Schaefer III / Anthony Fire / Thomas Südhof / Jean Frechet / \n", " Jack Szostak / Margaret Geller / James Tour / Jane Goodall / Charles Townes / Alan Guth / Harold Varmus / \n", " Lene Vestergaard Hau / Craig Venter / Stephen Hawking / James Watson / Peter Higgs / Steven Weinberg / \n", " Leroy Hood / George Whitesides / Eric Kandel / Edward Wilson / Andrew Knoll / Edward Witten / Charles Kao / \n", " Shinya Yamanaka''')" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "And here we show how it works:" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "' T|E.P|OP'" ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "solution = findregex(starwars, startrek)\n", "solution" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "not mistakes(solution, starwars, startrek) " ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Plan of Attack\n", "----\n", "\n", "To improve the program, I'll take the following steps:\n", "\n", "- *Profiling:* Figure out where the program spends its time.\n", "- *Speedup:* Make the program faster.\n", "- *Benchmarking:* Run the program over pairs of arbitrary lists to see how fast it is and how short the solutions are. \n", "- *Analyzing:* Learn something by looking at the benchmark results.\n", "- *Searching:* Introduce a better search algorithm.\n", "- *Eliminating Parts:* Get rid of parts that can't possibly be part of an optimal solution.\n", "- *Adding Parts:* Add new types of parts to allow new, shorter solutions.\n", "- *Randomizing Search:* Randomness allows us to explore different parts of the search space.\n", "- *Speculating:* Think about what we could do next.\n", "\n", "Profiling \n", "----\n", "\n", "Let's time how long it takes to separate the top 100 adverbs from top 100 nouns:" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "1 loops, best of 3: 5.4 s per loop\n" ] } ], "source": [ "%timeit findregex(adverbs, nouns)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "On my computer it was 4 seconds. I have some ideas for how to make this faster, but I know that I shouldn't waste effort trying to speed up parts of a program that [don't take much of the total time](http://en.wikipedia.org/wiki/Amdahl's_law). I'll use the [`cProfile`](http://docs.python.org/2/library/profile.html#module-cProfile) module to see where the time goes:" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ " 12220085 function calls in 7.748 seconds\n", "\n", " Ordered by: cumulative time\n", "\n", " ncalls tottime percall cumtime percall filename:lineno(function)\n", " 1 0.000 0.000 7.748 7.748 {built-in method builtins.exec}\n", " 1 0.000 0.000 7.748 7.748 :1()\n", " 1 0.001 0.001 7.748 7.748 :23(findregex)\n", " 54424 0.051 0.000 7.652 0.000 :39(matches)\n", " 54424 1.052 0.000 7.601 0.000 :41()\n", " 2841615 1.347 0.000 6.549 0.000 re.py:170(search)\n", " 2841615 1.482 0.000 4.016 0.000 re.py:278(_compile)\n", " 41 0.015 0.000 3.584 0.087 {built-in method builtins.max}\n", " 25445 0.033 0.000 3.569 0.000 :31(score)\n", " 41 0.021 0.001 3.335 0.081 :36()\n", " 45055 0.223 0.000 2.459 0.000 sre_compile.py:531(compile)\n", " 45055 0.169 0.000 1.206 0.000 sre_parse.py:819(parse)\n", " 2841615 1.186 0.000 1.186 0.000 {method 'search' of '_sre.SRE_Pattern' objects}\n", " 45055 0.080 0.000 0.911 0.000 sre_compile.py:516(_code)\n", " 1 0.000 0.000 0.825 0.825 :46(regex_parts)\n", " 45055 0.098 0.000 0.821 0.000 sre_parse.py:429(_parse_sub)\n", " 1 0.003 0.003 0.809 0.809 :50()\n", " 45055 0.281 0.000 0.660 0.000 sre_parse.py:491(_parse)\n", " 45055 0.263 0.000 0.650 0.000 sre_compile.py:412(_compile_info)\n", " 172941 0.076 0.000 0.246 0.000 sre_parse.py:247(get)\n", " 217996 0.212 0.000 0.212 0.000 sre_parse.py:226(__next)\n", " 45055 0.159 0.000 0.196 0.000 sre_parse.py:167(getwidth)\n", " 45055 0.141 0.000 0.177 0.000 sre_compile.py:64(_compile)\n", " 916825 0.129 0.000 0.129 0.000 {method 'append' of 'list' objects}\n", " 45055 0.074 0.000 0.122 0.000 sre_parse.py:217(__init__)\n", " 172941 0.067 0.000 0.091 0.000 sre_parse.py:165(append)\n", " 28890 0.078 0.000 0.082 0.000 sre_compile.py:391(_generate_overlap_table)\n", " 574427 0.058 0.000 0.058 0.000 {built-in method builtins.len}\n", " 45055 0.046 0.000 0.054 0.000 sre_parse.py:797(fix_flags)\n", " 90110 0.040 0.000 0.051 0.000 sre_compile.py:513(isstring)\n", " 135163 0.050 0.000 0.050 0.000 {built-in method builtins.min}\n", " 45055 0.048 0.000 0.048 0.000 {built-in method _sre.compile}\n", " 225275 0.043 0.000 0.043 0.000 {built-in method builtins.isinstance}\n", " 90110 0.032 0.000 0.042 0.000 sre_parse.py:75(groups)\n", " 45055 0.041 0.000 0.041 0.000 sre_parse.py:70(__init__)\n", " 45055 0.026 0.000 0.031 0.000 sre_parse.py:276(tell)\n", " 45055 0.029 0.000 0.029 0.000 sre_parse.py:105(__init__)\n", " 88 0.020 0.000 0.020 0.000 {method 'clear' of 'dict' objects}\n", " 57782 0.017 0.000 0.017 0.000 {method 'extend' of 'list' objects}\n", " 1 0.002 0.002 0.016 0.016 :49()\n", " 45055 0.014 0.000 0.014 0.000 sre_parse.py:242(match)\n", " 119455 0.013 0.000 0.013 0.000 {built-in method builtins.ord}\n", " 2131 0.005 0.000 0.012 0.000 :56(dotify)\n", " 45055 0.008 0.000 0.008 0.000 {method 'items' of 'dict' objects}\n", " 2131 0.004 0.000 0.005 0.000 :59()\n", " 14684 0.003 0.000 0.003 0.000 {method 'get' of 'dict' objects}\n", " 11135 0.002 0.000 0.002 0.000 {method 'join' of 'str' objects}\n", " 98 0.001 0.000 0.002 0.000 :52(subparts)\n", " 4921 0.001 0.000 0.001 0.000 :61(replacements)\n", " 2874 0.001 0.000 0.001 0.000 :54()\n", " 1 0.000 0.000 0.000 0.000 :48()\n", " 1 0.000 0.000 0.000 0.000 {method 'disable' of '_lsprof.Profiler' objects}\n", "\n", "\n" ] } ], "source": [ "import cProfile\n", "\n", "cProfile.run('findregex(adverbs, nouns)', sort='cumulative')" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "About 99% of the time was spent in `matches`. And most of the time in `matches` goes to `re.search`. So my thoughts are: \n", " \n", "+ Can we make each call to `matches` run faster? \n", "+ Can we make fewer calls to `matches`?\n", "+ Can we use `re.search` more effectively? \n", "+ Nothing else matters. 99% of the time is in `matches`; don't waste effort speeding up anything else.\n", "\n", "# Speedup: Faster `matches` by Compiling Regexes\n", "\n", "\n", "The `re` package uses strings to specify regular expressions, but internally, when we call `re.search` on a string, that string is compiled, with the function `re.compile`, into an object that has a `search` method. If you need to search many times with the same regex, then it is faster to call `re.compile` once, and then call the `search` method of the compiled object, rather than calling `re.search` each time.\n", "\n", "Another trick: use the builtin function `filter` rather than a set comprehension. Builtins, written in C, are often faster." ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def matches(regex, strings):\n", " \"Return a set of all the strings that are matched by regex.\"\n", " searcher = re.compile(regex).search\n", " return set(filter(searcher, strings))" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "One thing to be careful about: the `re` module manages a cache of recent compilations. I call `re.purge()` before each timing, to make sure that I'm not re-using any work that was done before the timing started." ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "1 loops, best of 3: 2.95 s per loop\n" ] } ], "source": [ "re.purge()\n", "\n", "%timeit findregex(adverbs, nouns)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "*That was almost twice as fast!* Not bad for changing two lines. \n", "\n", "# Speedup: Fewer `matches` Against Losers" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "In `regex_parts`, for each part, `p`, we test `if not matches(p, losers)`. This applies `searcher` to every loser and builds up a set of all those that match. It would be faster if we could *exit early*: as soon as we find one loser that matches, we don't need to apply `searcher` to the remaining losers. Stefan Pochmann came up with a great way to do this. If we concatenate the list of losers together into one big string, then we only need one call to `re.search` for each part `p`. If a part matches the big string anywhere, the call will return immediately, and we will know the part is no good. \n", "\n", "There is one catch: we have to make sure that the start of each loser matches `'^'` and the end matches `'$'`. We can do that by concatenating together the losers with a newline between them, and by using the `re.MULTILINE` option. (See the [`re` module documentation](http://docs.python.org/2/library/re.html) if this is unfamiliar.)\n", "\n", "Here is the change, with timing before and after:" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "1 loops, best of 3: 271 ms per loop\n" ] } ], "source": [ "re.purge()\n", "\n", "%timeit regex_parts(adverbs, nouns)" ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def regex_parts(winners, losers):\n", " \"Return parts that match at least one winner, but no loser.\"\n", " losers_str = '\\n'.join(losers)\n", " def no_losers(part): return not re.compile(part, re.MULTILINE).search(losers_str)\n", " wholes = {'^' + w + '$' for w in winners}\n", " parts = {d for w in wholes for p in subparts(w) for d in dotify(p)}\n", " return wholes | set(filter(no_losers, parts))" ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "10 loops, best of 3: 171 ms per loop\n" ] } ], "source": [ "re.purge()\n", "\n", "%timeit regex_parts(adverbs, nouns)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We've made `regex_parts` almost two times faster.\n", "\n", "# Speedup: Fewer `matches` Against Winners\n", "\n", "Here's what `findregex` currently looks like:" ] }, { "cell_type": "code", "execution_count": 13, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def findregex(winners, losers, k=4):\n", " \"Find a regex that matches all winners but no losers (sets of strings).\"\n", " # Make a pool of regex parts, then pick from them to cover winners.\n", " # On each iteration, add the 'best' part to 'solution',\n", " # remove winners covered by best, and keep in 'pool' only parts\n", " # that still match some winner.\n", " pool = regex_parts(winners, losers)\n", " solution = []\n", " def score(p): return k * len(matches(p, winners)) - len(p)\n", " while winners:\n", " best = max(pool, key=score)\n", " solution.append(best)\n", " winners = winners - matches(best, winners)\n", " pool = {p for p in pool if matches(p, winners)}\n", " return OR(solution)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Notice that we call `matches` twice (once within `score`) for every part in the pool on every iteration of the main loop. If there are 50 iterations of the loop, and 1000 parts, that's 100,000 calls to `matches`. Instead of repeating all these calls, I propose that, for each part in the pool, we limit ourselves to this:\n", "\n", "- One `re.compile`.\n", "- One `re.search` against each of the winners.\n", "- One `re.search` against the big string of losers.\n", "- Some cache lookups as needed.\n", "\n", "During initialization, we create a dict, called `covers`, that will serve as a cache: `covers[p]` is the set of all winners that match the part `p`. The new function `regex_covers` replaces the old function `regex_parts`. Here is the new `findregex`, with timing before and after:" ] }, { "cell_type": "code", "execution_count": 14, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "1 loops, best of 3: 2.85 s per loop\n" ] } ], "source": [ "re.purge()\n", "\n", "%timeit findregex(adverbs, nouns)" ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def findregex(winners, losers, k=4):\n", " \"Find a regex that matches all winners but no losers (sets of strings).\"\n", " # Initialize covers = {regex: {winner,...}} for a large set of regex components.\n", " # On each iteration, add the 'best' component to 'solution',\n", " # remove winners covered by best, and keep in 'pool' only components\n", " # that still match some winner.\n", " covers = regex_covers(winners, losers)\n", " pool = list(covers)\n", " solution = [] \n", " def score(p): return k * len(covers[p] & winners) - len(p)\n", " while winners:\n", " best = max(pool, key=score)\n", " solution.append(best)\n", " winners = winners - covers[best]\n", " pool = [p for p in pool \n", " if not covers[p].isdisjoint(winners)]\n", " return OR(solution)\n", "\n", "def regex_covers(winners, losers):\n", " \"\"\"Generate regex parts and return a dict of {regex: {winner,...}}.\n", " Each regex matches at least one winner and no loser.\"\"\"\n", " losers_str = '\\n'.join(losers)\n", " wholes = {'^' + w + '$' for w in winners}\n", " parts = {d for w in wholes for p in subparts(w) for d in dotify(p)}\n", " pool = wholes | parts\n", " searchers = {p: re.compile(p, re.MULTILINE).search for p in pool}\n", " return {p: Set(filter(searchers[p], winners)) \n", " for p in pool\n", " if not searchers[p](losers_str)}" ] }, { "cell_type": "code", "execution_count": 16, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "1 loops, best of 3: 251 ms per loop\n" ] } ], "source": [ "re.purge()\n", "\n", "%timeit findregex(adverbs, nouns)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "*Wow!* That's a dozen times faster! But I don't want to draw too many conclusions from just this one example." ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "# Benchmarking\n", "\n", "We will benchmark the program on a suite of 22 different problems (11 examples, run in both directions). The function `benchmark` finds a solution to each problem and prints the number of characters in the solution, and some other information. In the end it prints the total number of characters, and if we use the `%time` magic, we can see how long it took." ] }, { "cell_type": "code", "execution_count": 17, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "EXAMPLES = [ex for example in [\n", " (winners, 'win', 'lose', losers),\n", " (boys, 'boy', 'girl', girls),\n", " (pharma, 'drug', 'city', cities),\n", " (foo, 'foo', 'bar', bar),\n", " (starwars, 'wars', 'trek', startrek),\n", " (nouns, 'noun', 'adj', adverbs),\n", " (nouns, 'noun', 'verb', verbs),\n", " (randoms, 'rand', 'built', builtins),\n", " (dogs, 'dog', 'cat', cats),\n", " (movies, 'movie', 'tv', tv),\n", " (scientists, 'sci', 'star', stars)]\n", " for ex in (example, example[::-1])] # Do each example both ways\n", "\n", "SOLUTION = {} # A cached table of solutions; SOLUTION[W, L] will hold a regex\n", " \n", "def benchmark(examples=EXAMPLES): \n", " \"Run examples; print summaries; return total of solution lengths.\"\n", " totalchars = 0\n", " for (W, Wname, Lname, L) in examples:\n", " re.purge()\n", " solution = SOLUTION[W, L] = findregex(W, L)\n", " assert not mistakes(solution, W, L)\n", " legend = '{}({}):{}({})'.format(Wname, len(W), Lname, len(L))\n", " print('{:20} {:3}: \"{}\"'.format(legend, len(solution), truncate(solution, 50)))\n", " totalchars += len(solution)\n", " print('Total characters: {:6}'.format(totalchars))\n", " return totalchars\n", "\n", "def truncate(text, nchars, ellipsis=' ...'):\n", " \"Return whole string, or version truncated to nchars.\"\n", " return text if len(text) < nchars else text[:nchars-len(ellipsis)] + ellipsis" ] }, { "cell_type": "code", "execution_count": 18, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 54: \"a.a|i..n|j|li|a.t|a..i|bu|oo|ay.|n.e|r.e$|ru|l ...\"\n", "lose(34):win(34) 59: \"^d|^s|r.$|^.re|cc|hu|ld.|nd.|l.i|n.y|ya|ss|pa| ...\"\n", "boy(10):girl(10) 11: \"e.$|a.$|a.o\"\n", "girl(10):boy(10) 10: \"a$|^..i|is\"\n", "drug(10):city(10) 15: \"o.$|x|ir|f|q|^e\"\n", "city(10):drug(10) 11: \"ri|an|ca|id\"\n", "foo(21):bar(21) 3: \"f.o\"\n", "bar(21):foo(21) 28: \"r..$|k|.m|^..l|ld|c..n|id|or\"\n", "wars(6):trek(9) 9: \" T|E.P|W \"\n", "trek(9):wars(6) 15: \"TI|R.. |Y|RA|IS\"\n", "noun(100):adj(98) 170: \"m.n|a.e$|m$|in.$|en.$|ch.|^w.r|id|^g|io|s.n|o. ...\"\n", "adj(98):noun(100) 155: \"a.l|^..$|st$|et|re$|tl|en$|^al|ver$|nl|^a.o|ui ...\"\n", "noun(100):verb(94) 174: \"m.n|er$|am|es|^.ar|ho|.on|or.$|id|f.c|o.l|..h. ...\"\n", "verb(94):noun(100) 177: \"^..l|ak|ve$|^..$|s..n|a.n|^fi|^tr|ut$|.pe|o.g| ...\"\n", "rand(58):built(147) 76: \"ia|and|^_.e|_s|_.o|.G|e_|P.$|_e|ets|lti|^_.c|^ ...\"\n", "built(147):rand(58) 138: \"ro|Wa|as|^d|^i|r..i|li|^o|te.$|a.s$|m..$|up|tr ...\"\n", "dog(100):cat(91) 73: \"E.S$|O.S$|DS|.AS|.HI|RD|.D.E|ANS|IES|G.S|N.S$| ...\"\n", "cat(91):dog(100) 113: \"AI.$|T$|AN$|EX|A$|L$|Y$|A..B|NX|M.I|H$|R$|R.G| ...\"\n", "movie(100):tv(97) 157: \"GO| . |^N|HIN|S O|E IN|A.NI|.A.C|TIO|RIV|U.K|E ...\"\n", "tv(97):movie(100) 148: \"H.W|.CI|PR|R..$|D .E|A.ER|O..I|PE|^SE|^RO|T.C| ...\"\n", "sci(50):star(50) 70: \"AL..|T..N|R.S|.KA|NN|VE|-|MU|^P|OD|OS|L.O|W.I| ...\"\n", "star(50):sci(50) 77: \"CA|T. |LI..|F..D|GR|BU| GA|LO.|R..Y|UM| R| ST| ...\"\n", "Total characters: 1743\n", "CPU times: user 5.98 s, sys: 19.1 ms, total: 6 s\n", "Wall time: 6 s\n" ] }, { "data": { "text/plain": [ "1743" ] }, "execution_count": 18, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time benchmark()" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "In 5 seconds we solved 22 problems, getting a score of 1749 for the total number of characters in all the solutions. \n", "\n", "(**Note:** if you run this, you might get a slightly different answer. Why? The algorithm has no random parts in it; shouldn't it return the same result every time? It will return the same results if you run it twice in the same Python. But when `findregex` evaluates `max(pool, key=score)` and two components are tied for the best score, Python chooses the one that comes first in the iteration of `pool`. And different versions of Python can iterate over `pool` in different orders.)\n", "\n", "# Analyzing\n", "\n", "What can we do to understand the program better? Let's start by analyzing what the regex parts look like. We cached the solutions in `SOLUTION`, and we can start to examine the solutions and the parts they are made of. For example, how long are the parts that appears in solutions?" ] }, { "cell_type": "code", "execution_count": 19, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "Counter({1: 17, 2: 192, 3: 179, 4: 84, 7: 1, 10: 1})" ] }, "execution_count": 19, "metadata": {}, "output_type": "execute_result" } ], "source": [ "parts = [p for regex in SOLUTION.values() for p in regex.split('|')]\n", "lengths = [len(p) for p in parts]\n", "Counter(lengths)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "This says that there are 17 parts of length 1, 198 parts of length 2, etc. There's also one part of length 10; that's such an outlier, I wonder if it is an error? " ] }, { "cell_type": "code", "execution_count": 20, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "'^HAVANESE$'" ] }, "execution_count": 20, "metadata": {}, "output_type": "execute_result" } ], "source": [ "max(parts, key=len)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "I happen to own [a Havanese](http://pn.smugmug.com/Family/Dobby-Idgie/i-2JPzBkL/A), but I don't think the program knew that. Rather, the issue is that in the set of `cats` we have `'HAVANA BROWN'` and `'JAVANESE'`, which means that any 4-letter-or-less subsequence of `'HAVANESE'` matches one of these two. So the only component that doesn't match one of these two cats is the whole, `'^HAVANESE$'`." ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "\n", "\n", "What about the individual characters that make up the parts? Which ones are popular? We can see:" ] }, { "cell_type": "code", "execution_count": 21, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "[('.', 205),\n", " ('$', 71),\n", " ('a', 58),\n", " ('^', 54),\n", " ('e', 48),\n", " ('r', 46),\n", " ('o', 44),\n", " ('t', 37),\n", " ('i', 37),\n", " ('n', 37),\n", " ('l', 35),\n", " ('O', 31),\n", " ('E', 31),\n", " ('A', 30),\n", " ('s', 28),\n", " ('R', 27),\n", " ('S', 26),\n", " ('N', 24),\n", " ('u', 23),\n", " ('I', 23)]" ] }, "execution_count": 21, "metadata": {}, "output_type": "execute_result" } ], "source": [ "Counter(cat(parts)).most_common(20)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "I wonder if there are parts that appear in many solutions?" ] }, { "cell_type": "code", "execution_count": 22, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "[('id', 4),\n", " ('ru', 3),\n", " ('hu', 3),\n", " ('f.c', 2),\n", " ('oo', 2),\n", " ('f$', 2),\n", " ('lt', 2),\n", " ('m.n', 2),\n", " ('vi', 2),\n", " ('Y', 2),\n", " ('^..$', 2),\n", " ('N.S$', 2),\n", " ('rc', 2),\n", " ('^u', 2),\n", " ('a$', 2),\n", " ('j', 2),\n", " ('ls', 2),\n", " ('UG', 2),\n", " ('^..l', 2),\n", " ('YN', 2)]" ] }, "execution_count": 22, "metadata": {}, "output_type": "execute_result" } ], "source": [ "Counter(parts).most_common(20)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Most parts appear in only 2 solutions or less.\n", "\n", "# Analyzing: Set Cover Theory\n", "\n", "Now I want to think about this as a [set cover problem](http://en.wikipedia.org/wiki/Set_cover_problem). Wikipedia shows this diagram to explain set cover:\n", " \n", "\n", "\n", "The idea is that each blue dot in set $u$ on the left represents a regex component, and each green dot in set $v$ represents a winner that is matched by the regex component. The problem is to pick some blue dots such that all the green dots are covered. In this example, we can see that picking the blue dots that are second and third from the top will do it.\n", "\n", "But in general, what do our graphs look like? How many blue and green dots are there? How many links between them? Let's build a little tool to find out. We'll list the $N$ \"most popular\" blue and green dots—the ones with the most links to the other side. Then we'll show histograms of all the nodes and their numbers of links.\n", "\n", "But first some explanation: I use the term *multimap* for a dictionary, like `covers = {regex: {winner,...}}`, that maps keys to collections. Then `invert_multimap(covers)` is of the form `{winner: {regex, ...}}`." ] }, { "cell_type": "code", "execution_count": 23, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def show(W, L, N=10):\n", " \"Summarize the links between the set of winners, W, and its parts.\"\n", " covers = regex_covers(W, L)\n", " inv = invert_multimap(covers)\n", " for ((n1, w), (n2, r)) in zip(top(N, covers), top(N, inv)):\n", " print(\"{:8} {:2} | {:3}| {}\".format(w, n1, n2, r))\n", " print(\"TOTAL %5d | %3d TOTAL\" % (len(covers), len(W)))\n", " plt.subplot(1, 2, 1); histmm(covers, \"parts\", \"winners\")\n", " plt.subplot(1, 2, 2); histmm(inv, \"winners\", \"parts\")\n", " \n", "def top(N, multimap): \n", " \"The top N longest items in a dict of {key: {val,...})\"\n", " return sorted([(len(vals), key) for (key, vals) in multimap.items()], reverse=True)[:N]\n", "\n", "def histmm(multimap, key, val): \n", " \"Display a histogram of how many values each key has.\"\n", " plt.rcParams['figure.figsize'] = (8.0, 4.0)\n", " plt.hist([len(v) for v in multimap.values()])\n", " plt.xlabel('set size of {' + val + ',...}')\n", " plt.ylabel('number of ' + key + ' mapping to that size')\n", "\n", "def invert_multimap(multimap):\n", " \"Covert {key: {val,...}} to {val: [key,...]}.\"\n", " result = defaultdict(set)\n", " for key in multimap:\n", " for val in multimap[key]:\n", " result[val].add(key)\n", " return result" ] }, { "cell_type": "code", "execution_count": 24, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "i..n 4 | 110| van-buren\n", "a.a 4 | 98| washington\n", "a..i 4 | 93| jefferson\n", "r.i. 3 | 93| eisenhower\n", "r.i 3 | 81| garfield\n", "oo.. 3 | 78| roosevelt\n", "oo. 3 | 72| buchanan\n", "oo 3 | 61| obama\n", "ma 3 | 61| kennedy\n", "li.. 3 | 59| jackson\n", "TOTAL 1615 | 34 TOTAL\n" ] }, { "data": { "image/png": "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\ntaKdAAAAAElFTkSuQmCC\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "show(winners, losers)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "What does this say? First the table says that there are only three regexes that have 4 winners; all the rest have 3 or fewer winners. So the links going left-to-right are rather sparse. There are more links going the other direction; 110 to `van-buren`, for example. The histograms give the whole picture mapping set sizes to the number of keys that have that set size. So, on the left we see that over 1400 regexes have a set size of one winner, and 100 or fewer have set sizes of 2 and 3, and we saw that only 3 regexes have a set size of 4 winners. On the right, the histogram shows a wide spread of winners that have set sizes between 1 and 110 regexes.\n", "\n", "From looking at this I get two ideas:\n", " \n", "+ I notice that both `'oo..'` and `'oo.'` happen to match 3 winners. But even if I didn't know how many they matched, I would know that the winners matched by `'oo..'` must be a subset of the winners matched by `'oo.'` (remember that a set is a subset of itself). Furthermore, `'oo.'` is shorter. This suggests that we would *never* want to use `'oo..'` in a solution, because we could always make the solution one character shorter (and cover at least all the same winners) by substituting `'oo.'`. We say that * part A dominates B* if *A* is shorter and matches a superset of winners. We might as well throw out all dominated parts right at the start.\n", "\n", "+ It might be a good idea to pay special attention to the characters, like `'-'`, that appear in the winners but not the losers.\n", "\n", "Let's look at another example:" ] }, { "cell_type": "code", "execution_count": 25, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "E.S$ 41 | 186| SOFT COATED WHEATEN TERRIERS\n", "RS$ 34 | 184| STAFFORDSHIRE BULL TERRIERS\n", "ERS$ 34 | 175| GREATER SWISS MOUNTAIN DOGS\n", ".RS$ 34 | 162| TREEING WALKER COONHOUNDS\n", "IE.S 22 | 157| CAVALIER KING CHARLES SPANIELS\n", "E.RI 21 | 149| AMERICAN STAFFORDSHIRE TERRIERS\n", "T..R 20 | 147| WEST HIGHLAND WHITE TERRIERS\n", "IER. 19 | 146| STANDARD SCHNAUZERS\n", "IER 19 | 146| FLAT-COATED RETRIEVERS\n", "I.R. 19 | 146| CHESAPEAKE BAY RETRIEVERS\n", "TOTAL 4570 | 100 TOTAL\n" ] }, { "data": { "image/png": "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\n2wAAAABJRU5ErkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "show(dogs, cats)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "My immediate reaction to this is \"there are a lot of retrievers and terriers.\" All ten of the parts in the table recognize this fact, but the left-hand histogram shows that almost all the parts match fewer than 5 dog breeds. In contrast, the right-hand histogram shows that most of the dog breeds have 9 or more parts that match them.\n", "\n", "Let's look at one more example:" ] }, { "cell_type": "code", "execution_count": 26, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "a.l 12 | 94| especially\n", "a.ly 11 | 83| eventually\n", "a.l. 11 | 74| particularly\n", ".a.l 11 | 67| actually\n", "ll 9 | 65| quickly\n", "^..$ 9 | 65| exactly\n", ".ll 9 | 65| directly\n", "..ll 8 | 63| certainly\n", "all 7 | 61| usually\n", "st$ 6 | 57| recently\n", "TOTAL 2049 | 98 TOTAL\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "show(adverbs, nouns)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "The pattern looks similar here. Almost all the parts match only one winner, but most of the winners are matched by many parts. What can I conclude from this?\n", "\n", "+ It would be good to think of new types of parts that match more winners.\n", "+ Most parts are 2 or 3 characters long and most match just 1 or 2 winners. That suggests that often we will have a tie in the `score` function, and greedy search will arbitrarily pick the one that comes first. But I'm worried that another choice might be better. Maybe we should replace greedy search with something that considers more than one choice.\n", "\n", "Given all we've seen, I will shift my attention to understanding the search algorithm we have, and thinking about how to improve it." ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "# Analyzing: Understanding Greedy vs. Exhaustive Search\n", "\n", "`findregex` is a *greedy search* algorithm. In general, greedy search is used when you are trying to find a solution that is composed of parts. On each iteration you choose a part that looks good, and you never reconsider that choice; you just keep on adding parts until you get a complete solution. \n", "\n", "The pseudo-code for a general `greedy_search`, described as a recursive function, is given below. It takes two arguments: a set of parts, and a partial solution indicating parts that have previously been chosen. " ] }, { "cell_type": "code", "execution_count": 27, "metadata": { "button": false, "collapsed": true, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "# Pseudocode \n", "def greedy_search(parts, partial_solution=None):\n", " if is_complete(partial_solution):\n", " return partial_solution\n", " else:\n", " best = max(parts, key=score)\n", " return greedy_search(parts - {best}, partial_solution + best)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "An *exhaustive search* considers *every* possible choice of parts, and selects the best solution. On each iteration exhaustive search picks a part (just like greedy search), but then it considers *both* using the part and not using the part. You can see that exhaustive search is almost identical to greedy search, except that it has *two* recursive calls (on lines 7 and 8) instead of *one* (on line 7). (*If you are viewing this in a IPython notebook, not just a web page, you can toggle line numbers by pressing 'ctrl-M L' within a cell.*) How do we choose between the results of the two calls? We need a cost function that we are trying to minimize. (For regex golf the cost of a solution is the length of the string.)" ] }, { "cell_type": "code", "execution_count": 28, "metadata": { "button": false, "collapsed": true, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "# Pseudocode\n", "def exhaustive_search(parts, partial_solution=None):\n", " if is_complete(partial_solution):\n", " return partial_solution\n", " else:\n", " best = max(parts, key=score)\n", " return min(exhaustive_search(parts - {best}, partial_solution + best),\n", " exhaustive_search(parts - {best}, partial_solution),\n", " key=cost)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Here's an interesting piece of trivia: the first thing that exhaustive search does is a greedy search! Think about it: on each recursive call, `exhaustive_search` selects the best part, and then calls itself recursively with `best` chosen as part of the partial solution. It keeps going until it reaches a complete solution. That's exactly what greedy search does. But then exhaustive search does more: It also considers all the cases where it *didn't* choose the best part.\n", "\n", "Here's something else to ponder: why should we bother with selecting the \"best\" part? If we're going to explore *all* possibilities, wouldn't it be the same if we just selected *any* part, not the \"best\" one?\n", "\n", "# Searching: Computational Complexity of Greedy and Exhaustive Search\n", "\n", "\n", "Greedy search only considers one path towards the goal of finding a solution. Exhaustive search considers two paths on *every* iteration. How much work is that all together? If there are *P* parts, then there are $2^P$ subsets of parts. Now, we don't have to consider every one of these subsets, because the search ends when we cover all the winners. If there are $W$ winners, than an upper bound on the number of combinations we have to consider is the number of ways we can pick $W$ parts from a pool of $P$, which in math we write as ($P$ choose $W$). For the presidential candidates $W$, is 34, and $P$ is 1615.\n", "\n", "So exhaustive search would have to consider roughly [(1615 choose 34)](https://www.google.com/search?q=1615+choose+34) = $10^{70}$ combinations, which is clearly too many. Don't even think about dogs versus cats, where $W$ = 100 and $P$ = 4570, so [(4570 choose 100)](https://www.google.com/search?q=4570+choose+100) = $10^{207}$. Fortunately, there is another way.\n", "\n", "# Searching: Branch and Bound Search\n", "\n", "[*Branch and bound*](http://en.wikipedia.org/wiki/Branch_and_bound) is a search strategy that gets the same answer as exhaustive search, but runs faster because it avoids considering many combinations that could not possibly lead to an optimal solution. Here's how and why it works:\n", "\n", "- The *branch* part of the name means that, just like exhaustive search, on each iteration it picks a part, and considers two branches, one where the part is in the solution, and one where it is not. \n", "- The *bound* part of the name means that the algorithm continually keeps track of the lowest-cost solution it has found so far. This serves as a *bound* on what the optimal solution can be.\n", "- The *trick* is to notice that the cost of a partial solution always *increases* as we add more parts to it. Therefore, if we ever get to a partial solution whose cost is more than the lowest-cost solution we have found so far, then we can *immediately* discard the partial solution, and *never consider* all the other combinations that would have come from continuing the partial solution. If there are $MP$ parts left to consider, that means we just eliminated $2^P$ potential combinations all at once. \"Eliminating potential combinations\" is also called \"pruning the search tree\"—\"[pruning](https://www.google.com/search?q=pruning)\" means cutting off unwanted branches.\n", "\n", "The pseudocode below uses a global variable called `CHEAPEST` to hold the lowest-cost solution found so far. Note that the two branches (two recursive calls in lines 7 and 8) communicate through this global variable. If the first branch sets `CHEAPEST` to an improved solution, then the second branch will see it. That is why it is important to choose good \"best\" parts—it means we are more likely to find a good solution early on, which makes it more likely that we can prune away branches. " ] }, { "cell_type": "code", "execution_count": 29, "metadata": { "button": false, "collapsed": true, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "# Pseudocode\n", "def branch_and_bound_search(parts, partial_solution=None):\n", " if is_complete(partial_solution):\n", " CHEAPEST = min(CHEAPEST, partial_solution, key=cost)\n", " elif cost(partial_solution) < cost(CHEAPEST):\n", " best = select_best(parts)\n", " branch_and_bound_search(parts - {best}, partial_solution + best)\n", " branch_and_bound_search(parts - {best}, partial_solution)\n", " return CHEAPEST" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "\n", "\n", "# Searching: Anytime Branch and Bound Search\n", "\n", "Even with all this pruning, we still may be presented with problems that require trillions of recursive calls. [Who's got that kind of time?](http://www.gocomics.com/calvinandhobbes/1995/08/17#.UvSJImSwI8g) But if we stop the algorithm at any time, we still have our best solution stored in `CHEAPEST`. Algorithms that have the property that an answer is always available are called [*anytime algorithms*](http://en.wikipedia.org/wiki/Anytime_algorithm); let's do that.\n", "\n", "I can think of two easy ways to allow early stopping. We could use the [`threading.Timer`](http://docs.python.org/2/library/threading.html#timer-objects) class to run the search for a given number of seconds, then stop. Or we could have a counter which gets decremented every time we make a call, and when it hits zero, stop. I'll use the second approach.\n", "\n", "Enough pseudocode—here is a real implementation. Since global variables are [considered bad style](https://google.github.io/styleguide/pyguide.html#Global_variables), I decided to use a class, `BranchBound`, to hold the lowest-cost solution and the number of calls remaining. The class provides one method, `search`, which does the work." ] }, { "cell_type": "code", "execution_count": 30, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "class BranchBound(object):\n", " \"Hold state information for a branch and bound search.\"\n", " def __init__(self, winners, max_num_calls, k=4):\n", " self.cheapest = trivial(winners)\n", " self.calls = max_num_calls\n", " self.k = k\n", " \n", " def search(self, covers, partial=None):\n", " \"\"\"Recursively extend partial regex until it matches all winners in covers.\n", " Try all reasonable combinations until we run out of calls.\"\"\"\n", " if self.calls <= 0: \n", " return self.cheapest\n", " self.calls -= 1\n", " covers, partial = simplify_covers(covers, partial)\n", " if not covers: # Nothing left to cover; solution is complete\n", " self.cheapest = min(partial, self.cheapest, key=len)\n", " elif len(OR(partial, min(covers, key=len))) < len(self.cheapest):\n", " def score(p): return self.k * len(covers[p]) - len(p)\n", " best = max(covers, key=score) # Best part\n", " covered = covers[best] # Set of winners covered by best\n", " covers.pop(best)\n", " # Try with and without the greedy-best part\n", " self.search({c:covers[c]-covered for c in covers}, OR(partial, best))\n", " self.search(covers, partial)\n", " return self.cheapest" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "# Simplifying Covers\n", "\n", "There's a new function introduced above, `simplify_covers`. The idea is that you pass it a `covers` dict and a partial regex, and it does a triage process to divide the components in `covers` into three categories:\n", "\n", "- *Useless components*: could never appear in an optimal solution.\n", "- *Necessary components*: must appear in any solution (because no other component covers some winner).\n", "- *Remaining components*: neither useless nor necessary.\n", " \n", "The necessary components are joined to the partial regex that is passed in, to yield a new partial regex that the function returns. The useless components are eliminated, and the remaining ones are returned in a new `covers` dict. \n", "\n", "`simplify_covers` works by first eliminating useless components, and then selecting necessary components. We keep repeating this process of eliminating and selecting until there are no more changes to `covers`:" ] }, { "cell_type": "code", "execution_count": 31, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def simplify_covers(covers, partial=None):\n", " \"Eliminate dominated regexes, and select ones that uniquely cover a winner.\"\n", " previous = None\n", " while covers != previous:\n", " previous = covers\n", " covers = eliminate_dominated(covers)\n", " covers, necessary = select_necessary(covers)\n", " partial = OR(partial, necessary)\n", " return covers, partial" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "For convenience we modified the function `OR` slightly; we made it work just like the function `max` in that you can call it two ways: either with a single argument, which is a collection of components, or with 2 or more arguments, each a component. We also made it ignore components that are `None`, so that `OR(None, 'a')` equals `'a'`, but `OR('a', 'b')` equals `'a|b'`, as does `OR(['a', 'b'])`" ] }, { "cell_type": "code", "execution_count": 32, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def OR(*regexes):\n", " \"\"\"OR together component regexes. Ignore 'None' components.\n", " Allows both OR(a, b, c) and OR([a, b, c]), similar to max.\"\"\"\n", " if len(regexes) == 1: \n", " regexes = regexes[0]\n", " return '|'.join(r for r in regexes if r)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "# Simplifying Covers: Eliminating Dominated Components\n", "\n", "We defined the notion of a regex being *dominated* if there is some other regex that is shorter (or at least not longer) and covers a superset of winners. How can we efficiently compute which parts are dominated? Here's one simple approach: go through each regex part, `p`, and every time we find one that is not dominated by any another regex part `p2`, add `p` (and its winners) to a new dict that we are building up. This approach works, but it is $O(n^2)$.\n", "\n", "Here's an alternative that is faster: First, sort all the regexes so that the ones that match more winners come first (in case of tie, put the shorter ones first). (In other words, \"best\" first.) Initialize a new dict to empty, and go through the sorted regexes, `p`, one at a time. For each `p`, compare it only to the regexes, `p2`, that we have already added to the new dict; if none of them dominate `p`, then add `p`. This is still $O(n^2)$, but if, say, 99 out of 100 regexes are eliminated, we will only need $n^2/100$ comparisons.\n", "\n", "The code for `eliminate_dominated` is a slight variant on the [version](https://github.com/pochmann/regex-golf) by Stefan Pochmann (because his version turned out to be better than my first version). Note that the function `signature` represents a regex as a pair of numbers, the negative of the number of winners and the length in characters. The smaller (in lexicographical order) this pair is, the \"better\" the regex is. Why is it important to put the regexes in sorted order? So that we know that the only possible dominators are the ones that came *before*, not ones that come after. Note that, as we are going through the component regexes, `p`, in sorted order, if we ever hit a `p` that covers no winners, then we know that all the remaining `p` will also cover no winners (because we're going in best-first order), so we can break out of the loop immediately. And one more thing: the expression `covers[p2] >= covers[p]` asks if `p2` covers a superset of the winners that `p` covers." ] }, { "cell_type": "code", "execution_count": 33, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def eliminate_dominated(covers):\n", " \"\"\"Given a dict of {regex: {winner...}}, make a new dict with only the regexes\n", " that are not dominated by any others. A regex part p is dominated by p2 if p2 covers \n", " a superset of the matches covered by p, and rp is shorter.\"\"\"\n", " newcovers = {}\n", " def signature(p): return (-len(covers[p]), len(p))\n", " for p in sorted(covers, key=signature):\n", " if not covers[p]: break # All remaining r must not cover anything\n", " # r goes in newcache if it is not dominated by any other regex\n", " if not any(covers[p2] >= covers[p] and len(p2) <= len(p) \n", " for p2 in newcovers):\n", " newcovers[p] = covers[p]\n", " return newcovers" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "# Simplifying Covers: Selecting Necessary Components\n", "\n", "\n", "If some winner is covered by only one part, then we know that part must be part of the solution. The function `select_necessary` finds all such parts, `OR`s them together, and returns that, along with a dict of the remaining covers, after removing the necessary parts (and removing all the winners that are covered by the neccessary parts)." ] }, { "cell_type": "code", "execution_count": 34, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def select_necessary(covers):\n", " \"\"\"Select winners covered by only one part; remove from covers.\n", " Return a pair of (covers, necessary).\"\"\"\n", " counts = Counter(w for p in covers for w in covers[p])\n", " necessary = {p for p in covers if any(counts[w] == 1 for w in covers[p])}\n", " if necessary:\n", " covered = {w for p in necessary for w in covers[p]}\n", " covers = {p: covers[p] - covered \n", " for p in covers if p not in necessary}\n", " return covers, OR(necessary)\n", " else:\n", " return covers, None" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "# Testing and Benchmarking: Branch and Bound\n", "\n", "Let's make up a test suite (showing some examples of how these functions work). Then let's see if `findregex` works with the new branch and bound search. " ] }, { "cell_type": "code", "execution_count": 35, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "'test_bb passes'" ] }, "execution_count": 35, "metadata": {}, "output_type": "execute_result" } ], "source": [ "def test_bb():\n", " assert OR(['a', 'b', 'c']) == OR('a', 'b', 'c') == 'a|b|c'\n", " assert OR(['a|b', 'c|d']) == OR('a|b', 'c|d') == 'a|b|c|d'\n", " assert OR(None, 'c') == 'c'\n", " covers1 = {'a': {'ann', 'abe'}, 'ab': {'abe'}}\n", " assert eliminate_dominated(covers1) == {'a': {'ann', 'abe'}}\n", " assert simplify_covers(covers1) == ({}, 'a')\n", " covers2 = {'a': {'abe', 'cab'}, 'b': {'abe', 'cab', 'bee'}, \n", " 'c': {'cab', 'cee'}, 'c.': {'cab', 'cee'}, 'abe': {'abe'},\n", " 'ab': {'abe', 'cab'}, '.*b': {'abe', 'cab', 'bee'}, \n", " 'e': {'abe', 'bee', 'cee'}, 'f': {}, 'g': {}}\n", " assert eliminate_dominated(covers2) == simplify_covers(covers2)[0] == {\n", " 'c': {'cab', 'cee'}, 'b': {'cab', 'abe', 'bee'}, 'e': {'cee', 'abe', 'bee'}}\n", " covers3 = {'1': {'w1'}, '.1': {'w1'}, '2': {'w2'}}\n", " assert eliminate_dominated(covers3) == {'1': {'w1'}, '2': {'w2'}}\n", " assert simplify_covers(covers3) in (({}, '2|1'), ({}, '1|2'))\n", " covers, nec = select_necessary({'a': {'abe'}, 'c': {'cee'}})\n", " assert covers == {} and (nec == 'c|a' or nec == 'a|c')\n", " assert {0, 1, 2} >= {1, 2}\n", " assert {1, 2} >= {1, 2}\n", " assert not ({1, 2, 4} >= {1, 3})\n", " return 'test_bb passes'\n", "\n", "test_bb()" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Let's investigate how much the cover simplification process is helping:" ] }, { "cell_type": "code", "execution_count": 36, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "1615" ] }, "execution_count": 36, "metadata": {}, "output_type": "execute_result" } ], "source": [ "covers = regex_covers(winners, losers)\n", "len(covers)" ] }, { "cell_type": "code", "execution_count": 37, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "49" ] }, "execution_count": 37, "metadata": {}, "output_type": "execute_result" } ], "source": [ "covers2, partial = simplify_covers(covers)\n", "len(covers2)" ] }, { "cell_type": "code", "execution_count": 38, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "0.9696594427244583" ] }, "execution_count": 38, "metadata": {}, "output_type": "execute_result" } ], "source": [ "1 - len(covers2)/len(covers)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We see that `simplify_covers` gives us a 97% reduction in the number of parts! What do the remaining covers look like?" ] }, { "cell_type": "code", "execution_count": 39, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "({'-': frozenset({'van-buren'}),\n", " '.b': frozenset({'obama', 'van-buren'}),\n", " '.f': frozenset({'garfield', 'taft'}),\n", " '.h.n': frozenset({'buchanan', 'washington'}),\n", " '.se': frozenset({'eisenhower', 'roosevelt'}),\n", " 'a..i': frozenset({'garfield', 'harding', 'harrison', 'washington'}),\n", " 'a.a': frozenset({'adams', 'buchanan', 'obama', 'reagan'}),\n", " 'a.t': frozenset({'carter', 'grant', 'taft'}),\n", " 'ad': frozenset({'adams', 'madison'}),\n", " 'am': frozenset({'adams', 'obama'}),\n", " 'an.$': frozenset({'cleveland', 'grant'}),\n", " 'ay.': frozenset({'hayes', 'taylor'}),\n", " 'bu': frozenset({'buchanan', 'bush', 'van-buren'}),\n", " 'di': frozenset({'harding', 'madison'}),\n", " 'ed': frozenset({'kennedy'}),\n", " 'el.$': frozenset({'garfield', 'roosevelt'}),\n", " 'g..n': frozenset({'grant', 'washington'}),\n", " 'ga': frozenset({'garfield', 'reagan'}),\n", " 'h..e': frozenset({'eisenhower', 'hayes'}),\n", " 'ho': frozenset({'eisenhower', 'hoover'}),\n", " 'i..n': frozenset({'eisenhower', 'harrison', 'madison', 'nixon'}),\n", " 'i..o': frozenset({'clinton', 'lincoln', 'wilson'}),\n", " 'i.l': frozenset({'garfield', 'mckinley'}),\n", " 'i.o': frozenset({'harrison', 'madison', 'nixon'}),\n", " 'ie.': frozenset({'garfield', 'pierce'}),\n", " 'is.': frozenset({'eisenhower', 'harrison', 'madison'}),\n", " 'li': frozenset({'clinton', 'coolidge', 'lincoln'}),\n", " 'ls': frozenset({'wilson'}),\n", " 'm..i': frozenset({'madison', 'mckinley'}),\n", " 'ma': frozenset({'madison', 'obama', 'truman'}),\n", " 'n..o': frozenset({'nixon', 'washington'}),\n", " 'n.e': frozenset({'kennedy', 'mckinley'}),\n", " 'nl': frozenset({'mckinley'}),\n", " 'oe': frozenset({'monroe'}),\n", " 'oo': frozenset({'coolidge', 'hoover', 'roosevelt'}),\n", " 'r..s': frozenset({'harrison', 'roosevelt'}),\n", " 'r.e$': frozenset({'monroe', 'pierce'}),\n", " 'r.i': frozenset({'garfield', 'harding', 'harrison'}),\n", " 'r.n': frozenset({'grant', 'van-buren'}),\n", " 'ra': frozenset({'grant'}),\n", " 'rc': frozenset({'pierce'}),\n", " 'rt': frozenset({'carter'}),\n", " 'sh': frozenset({'bush', 'washington'}),\n", " 'ta': frozenset({'taft', 'taylor'}),\n", " 'to': frozenset({'clinton', 'washington'}),\n", " 'u..n': frozenset({'truman', 'van-buren'}),\n", " 'vel': frozenset({'cleveland', 'roosevelt'}),\n", " 'xo': frozenset({'nixon'}),\n", " 'ye': frozenset({'hayes'})},\n", " 'j|po')" ] }, "execution_count": 39, "metadata": {}, "output_type": "execute_result" } ], "source": [ "simplify_covers(covers)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ " Now let's benchmark branch and bound. I'm going to introduce a modified version of `benchmark`, called `bbenchmark`, to print the number of calls taken. The easiest way to do that is to introduce a new version of `findregex`, called `bb_findregex`, that returns the `BranchBound` object it creates, rather than returning the solution. (In general, I tend to introduce a new function when I change the call/return signature, but not when I just improve the mechanism.)" ] }, { "cell_type": "code", "execution_count": 40, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def bbenchmark(examples=EXAMPLES, calls=10**4): \n", " \"Run these data sets; print summaries; return total of solution lengths.\"\n", " totalchars = 0\n", " for (W, Wname, Lname, L) in examples: # Do both ways\n", " re.purge()\n", " bb = bb_findregex(W, L, calls)\n", " SOLUTION[W, L] = bb.cheapest\n", " assert not mistakes(bb.cheapest, W, L)\n", " legend = '{}({}):{}({})'.format(Wname, len(W), Lname, len(L))\n", " print('{:20} {:6} calls, {:3}: \"{}\"'.format(\n", " legend, (calls - bb.calls), len(bb.cheapest), truncate(bb.cheapest, 45)))\n", " totalchars += len(bb.cheapest)\n", " return totalchars\n", "\n", "def bb_findregex(winners, losers, calls=10**4):\n", " \"Return a BranchBound object which contains the shortest regex that covers winners but not losers.\"\n", " bb = BranchBound(winners, calls)\n", " bb.search(regex_covers(winners, losers))\n", " return bb\n", "\n", "def findregex(winners, losers): return bb_findregex(winners, losers).cheapest" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Remember, the old benchmark took about 5 seconds and totaled 1749 characters. Let's see how the branch and bound benchmark compares:" ] }, { "cell_type": "code", "execution_count": 41, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 1000 calls, 52: \"j|po|a.a|a..i|bu|ma|li|ls|a.t|vel|ho|xo|a ...\"\n", "lose(34):win(34) 1000 calls, 58: \"^s|ox|ss|^ki|^d|go|^.re|hu|ry|ai|k..$|n.y ...\"\n", "boy(10):girl(10) 9 calls, 11: \"de|a.$|c|as\"\n", "girl(10):boy(10) 13 calls, 10: \"a$|a.i|e.i\"\n", "drug(10):city(10) 3 calls, 15: \"ir|^e|o.$|f|x|q\"\n", "city(10):drug(10) 17 calls, 11: \"ri|an|h|a.e\"\n", "foo(21):bar(21) 1 calls, 3: \"f.o\"\n", "bar(21):foo(21) 205 calls, 24: \"k|ld|b|...n|ah|ar|or|z|A\"\n", "wars(6):trek(9) 21 calls, 9: \" T|E..H|B\"\n", "trek(9):wars(6) 9 calls, 13: \"IS|Y|RA|CT| F\"\n", "noun(100):adj(98) 1000 calls, 167: \"f.t|^hea|aw$|^g|jo|rty|rt$|ot$|^wa|o.y|el ...\"\n", "adj(98):noun(100) 721 calls, 146: \"r.t|re$|f$|st$|at$|rse|b.t|a.l|ui|far|u.h ...\"\n", "noun(100):verb(94) 1000 calls, 168: \"am|er$|t.t|ir|po|ot|.as|^ar|^en|gu|.ne|ac ...\"\n", "verb(94):noun(100) 1000 calls, 170: \"c.n|p.y|sw|r.ad|^tr|ru|^fi|un.$|it$|b.y|^ ...\"\n", "rand(58):built(147) 1000 calls, 73: \"ia|_p|a.p|ee|_e|and|ets|^u|lti|^_.e|_s|_. ...\"\n", "built(147):rand(58) 1000 calls, 130: \"^i|se.$|^range$|Y|..E|xe|Wa|bo|ev|w$|xt|^ ...\"\n", "dog(100):cat(91) 1000 calls, 69: \"^HAVANESE$|E.S$|O.S$|N.S$|.AS|GS|.HI|RD|B ...\"\n", "cat(91):dog(100) 539 calls, 104: \"J.V|NX|H$|AN$|EX|OE|BAL|^TH|Y$|T$|R$|MES| ...\"\n", "movie(100):tv(97) 1000 calls, 154: \"^GR|R W|LAD|^CI|GO| . |AP.|^N|^RA|HIN|NC. ...\"\n", "tv(97):movie(100) 1000 calls, 146: \"MAS|^.OS|WIR|EER|OAP|4|H.W|6|.CI|X.$|.MO| ...\"\n", "sci(50):star(50) 1000 calls, 67: \"AL..|T..N|R.S| TO|.KA|KN|OS|MU|VE|NN|Ü|LE ...\"\n", "star(50):sci(50) 1000 calls, 76: \"UM|WES|CA|T. | ST|YN|LI..|F..D|GR|BU| GA| ...\"\n", "CPU times: user 8.05 s, sys: 23.4 ms, total: 8.07 s\n", "Wall time: 8.07 s\n" ] }, { "data": { "text/plain": [ "1676" ] }, "execution_count": 41, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=1000)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "This is encouraging! We took about 2 seconds longer, but improved on the total number of characters by about 4%. For 10 of the 22 cases we didn't reach the cutoff of 1000 calls, which means that we searched every feasible combination of the parts we have. Let's try with 10,000 calls:" ] }, { "cell_type": "code", "execution_count": 42, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 1707 calls, 52: \"j|po|a.a|a..i|bu|ma|li|ls|a.t|vel|ho|xo|a ...\"\n", "lose(34):win(34) 3075 calls, 57: \"^s|ox|ss|^ki|i.$|go|^f|de|br|hu|ker|le$|e ...\"\n", "boy(10):girl(10) 9 calls, 11: \"de|a.$|c|as\"\n", "girl(10):boy(10) 13 calls, 10: \"a$|a.i|e.i\"\n", "drug(10):city(10) 3 calls, 15: \"ir|^e|o.$|f|x|q\"\n", "city(10):drug(10) 17 calls, 11: \"ri|an|h|a.e\"\n", "foo(21):bar(21) 1 calls, 3: \"f.o\"\n", "bar(21):foo(21) 205 calls, 24: \"k|ld|b|...n|ah|ar|or|z|A\"\n", "wars(6):trek(9) 21 calls, 9: \" T|E..H|B\"\n", "trek(9):wars(6) 9 calls, 13: \"IS|Y|RA|CT| F\"\n", "noun(100):adj(98) 2009 calls, 167: \"f.t|^hea|aw$|^g|jo|rty|rt$|ot$|^wa|o.y|el ...\"\n", "adj(98):noun(100) 721 calls, 146: \"r.t|re$|f$|st$|at$|rse|b.t|a.l|ui|far|u.h ...\"\n", "noun(100):verb(94) 10000 calls, 168: \"am|er$|t.t|ir|po|ot|.as|^ar|^en|gu|.ne|ac ...\"\n", "verb(94):noun(100) 3285 calls, 170: \"c.n|p.y|sw|r.ad|^tr|ru|^fi|un.$|it$|b.y|^ ...\"\n", "rand(58):built(147) 1427 calls, 73: \"ia|_p|a.p|ee|_e|and|ets|^u|lti|^_.e|_s|_. ...\"\n", "built(147):rand(58) 10000 calls, 130: \"^i|se.$|^range$|Y|ro|Wa|bo|ev|w$|xt|^d|^o ...\"\n", "dog(100):cat(91) 10000 calls, 69: \"^HAVANESE$|E.S$|O.S$|N.S$|.AS|GS|.HI|RD|B ...\"\n", "cat(91):dog(100) 539 calls, 104: \"J.V|NX|H$|AN$|EX|OE|BAL|^TH|Y$|T$|R$|MES| ...\"\n", "movie(100):tv(97) 10000 calls, 153: \"^GR|R W|LAD|^CI|GO| . |AP.|^N|^RA|HIN|NC. ...\"\n", "tv(97):movie(100) 10000 calls, 146: \"MAS|^.OS|WIR|EER|OAP|4|H.W|6|.CI|X.$|.MO| ...\"\n", "sci(50):star(50) 10000 calls, 67: \"AL..|T..N|R.S| TO|.KA|KN|OS|MU|NN|W.I|IG. ...\"\n", "star(50):sci(50) 10000 calls, 76: \"UM|WES|CA|T. | ST|YN|F..D|GR| GA|H.P|LO.| ...\"\n", "CPU times: user 20.2 s, sys: 40.4 ms, total: 20.3 s\n", "Wall time: 20.3 s\n" ] }, { "data": { "text/plain": [ "1674" ] }, "execution_count": 42, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=10000)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We doubled the time and gained a few characters. How about 100,000 calls?" ] }, { "cell_type": "code", "execution_count": 43, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 1707 calls, 52: \"j|po|a.a|a..i|bu|ma|li|ls|a.t|vel|ho|xo|a ...\"\n", "lose(34):win(34) 3075 calls, 57: \"^s|ox|ss|^ki|i.$|go|^f|de|br|hu|ker|le$|e ...\"\n", "boy(10):girl(10) 9 calls, 11: \"de|a.$|c|as\"\n", "girl(10):boy(10) 13 calls, 10: \"a$|a.i|e.i\"\n", "drug(10):city(10) 3 calls, 15: \"ir|^e|o.$|f|x|q\"\n", "city(10):drug(10) 17 calls, 11: \"ri|an|h|a.e\"\n", "foo(21):bar(21) 1 calls, 3: \"f.o\"\n", "bar(21):foo(21) 205 calls, 24: \"k|ld|b|...n|ah|ar|or|z|A\"\n", "wars(6):trek(9) 21 calls, 9: \" T|E..H|B\"\n", "trek(9):wars(6) 9 calls, 13: \"IS|Y|RA|CT| F\"\n", "noun(100):adj(98) 2009 calls, 167: \"f.t|^hea|aw$|^g|jo|rty|rt$|ot$|^wa|o.y|el ...\"\n", "adj(98):noun(100) 721 calls, 146: \"r.t|re$|f$|st$|at$|rse|b.t|a.l|ui|far|u.h ...\"\n", "noun(100):verb(94) 100000 calls, 167: \"am|er$|t.t|ir|po|ot|.as|^ar|^en|gu|.ne|ac ...\"\n", "verb(94):noun(100) 3285 calls, 170: \"c.n|p.y|sw|r.ad|^tr|ru|^fi|un.$|it$|b.y|^ ...\"\n", "rand(58):built(147) 1427 calls, 73: \"ia|_p|a.p|ee|_e|and|ets|^u|lti|^_.e|_s|_. ...\"\n", "built(147):rand(58) 94795 calls, 127: \"^i|se.$|^range$|Y|ro|Wa|bo|ev|w$|xt|^d|^o ...\"\n", "dog(100):cat(91) 100000 calls, 69: \"^HAVANESE$|E.S$|O.S$|N.S$|.AS|GS|.HI|RD|B ...\"\n", "cat(91):dog(100) 539 calls, 104: \"J.V|NX|H$|AN$|EX|OE|BAL|^TH|Y$|T$|R$|MES| ...\"\n", "movie(100):tv(97) 100000 calls, 153: \"^GR|R W|LAD|^CI|GO| . |AP.|^N|^RA|HIN|NC. ...\"\n", "tv(97):movie(100) 100000 calls, 146: \"MAS|^.OS|WIR|EER|OAP|4|H.W|6|.CI|X.$|.MO| ...\"\n", "sci(50):star(50) 100000 calls, 67: \"AL..|T..N|I$|.KA|KN|OS|VE|I.O| TO| .RE|LE ...\"\n", "star(50):sci(50) 100000 calls, 75: \"UM|WES|CA|GR|LO.|F..D|^B|DEA| GA|H.P|I.L| ...\"\n", "CPU times: user 3min 8s, sys: 333 ms, total: 3min 8s\n", "Wall time: 3min 8s\n" ] }, { "data": { "text/plain": [ "1669" ] }, "execution_count": 43, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=100000)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We're slowly decreasing the total number of characters, but at the expense of increasing run time. I think if we want to make more progress, it is time to stop worrying about the search algorithm, and start worrying about what we're searching over.\n", "\n", "# New Parts: Repetition Characters\n", "\n", "Following a suggestion by Stefan Pochmann, I will generate two new classes of parts that use the repetition characters `'*'`, `'+'`, and `'?'`:\n", "\n", "- **pairs**: parts of the form `'A.*B'` where `'A'` and `'B'` are any two non-special characters that appear anywhere in any winner, the dot is always the second character, and the third character is one of the repetition characters. \n", "\n", "- **reps**: given a part such as `'a.c'`, insert any repetition character after any character in the part (yielding, for example, `'a*.c'`).\n", "Don't insert after `'^'` or `'$'`, and don't allow redundant parts like `'..*c'`.\n", "\n", "\n", "Here is a new version of `regex_covers` that adds the new parts:" ] }, { "cell_type": "code", "execution_count": 44, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def regex_covers(winners, losers):\n", " \"\"\"Generate regex components and return a dict of {regex: {winner...}}.\n", " Each regex matches at least one winner and no loser.\"\"\"\n", " losers_str = '\\n'.join(losers)\n", " wholes = {'^'+winner+'$' for winner in winners}\n", " parts = {d for w in wholes for p in subparts(w) for d in dotify(p)}\n", " reps = {r for p in parts for r in repetitions(p)}\n", " pool = wholes | parts | pairs(winners) | reps \n", " searchers = {p:re.compile(p, re.MULTILINE).search for p in pool}\n", " return {p: Set(filter(searchers[p], winners)) \n", " for p in pool\n", " if not searchers[p](losers_str)}\n", "\n", "def pairs(winners, special_chars=Set('*+?^$.[](){}|\\\\')):\n", " chars = Set(cat(winners)) - special_chars\n", " return {A+'.'+q+B \n", " for A in chars for B in chars for q in '*+?'}\n", "\n", "def repetitions(part):\n", " \"\"\"Return a set of strings derived by inserting a single repetition character\n", " ('+' or '*' or '?'), after each non-special character. \n", " Avoid redundant repetition of dots.\"\"\"\n", " splits = [(part[:i], part[i:]) for i in range(1, len(part)+1)]\n", " return {A + q + B \n", " for (A, B) in splits\n", " # Don't allow '^*' nor '$*' nor '..*' nor '.*.'\n", " if not (A[-1] in '^$')\n", " if not A.endswith('..')\n", " if not (A.endswith('.') and B.startswith('.'))\n", " for q in '*+?'}" ] }, { "cell_type": "code", "execution_count": 45, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "'test_new_parts passes'" ] }, "execution_count": 45, "metadata": {}, "output_type": "execute_result" } ], "source": [ "def test_new_parts():\n", " assert repetitions('a') == {'a+', 'a*', 'a?'}\n", " assert repetitions('ab') == {'a+b', 'a*b', 'a?b', \n", " 'ab+', 'ab*', 'ab?'}\n", " assert repetitions('a.c') == {'a+.c', 'a*.c', 'a?.c',\n", " 'a.c+', 'a.*c', 'a.?c',\n", " 'a.+c', 'a.c*', 'a.c?'}\n", " assert repetitions('^a..d$') == {'^a+..d$', '^a*..d$', '^a?..d$', \n", " '^a..d+$', '^a..d*$', '^a..d?$'}\n", " assert pairs({'ab', 'c'}) == {\n", " 'a.*a', 'a.*b', 'a.*c',\n", " 'a.+a', 'a.+b', 'a.+c',\n", " 'a.?a', 'a.?b', 'a.?c',\n", " 'b.*a', 'b.*b', 'b.*c',\n", " 'b.+a', 'b.+b', 'b.+c',\n", " 'b.?a', 'b.?b', 'b.?c',\n", " 'c.*a', 'c.*b', 'c.*c',\n", " 'c.+a', 'c.+b', 'c.+c',\n", " 'c.?a', 'c.?b','c.?c'}\n", " assert len(pairs({'1...2...3', '($2.34)', '42', '56', '7-11'})) == 8 * 8 * 3\n", " covers = regex_covers({'one', 'on'}, {'won', 'wuan', 'juan'})\n", " assert (eliminate_dominated(covers) == {'e': {'one'}, '^o': {'on', 'one'}})\n", " return 'test_new_parts passes'\n", "\n", "test_new_parts()" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Let's take our new parts out for a spin and see what they can do:" ] }, { "cell_type": "code", "execution_count": 46, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "' T|P.*E'" ] }, "execution_count": 46, "metadata": {}, "output_type": "execute_result" } ], "source": [ "findregex(starwars, startrek)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "**Awesome!** \n", "\n", "Remember, Randall had a ten character regex in the strip (see below); we previously got it down to nine, but we now have it down to **seven** with `' T|P.*E'`!\n", "\n", "\n", "\n", "**Update(Nov 2015)**: There are two new movies in the works; let's see what they do to our golf score:" ] }, { "cell_type": "code", "execution_count": 47, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "' T|P.*E|KE'" ] }, "execution_count": 47, "metadata": {}, "output_type": "execute_result" } ], "source": [ "starwars = starwars | {'THE FORCE AWAKENS'}\n", "startrek = startrek | {'BEYOND'}\n", "\n", "findregex(starwars, startrek)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Too bad; back to ten characters.\n", "\n", "How much more work are we doing with these additional parts? Before, `regex_covers(winners, losers)` gave 1615 regexes, which were reduced to 49 by `simplify_covers`. Now:" ] }, { "cell_type": "code", "execution_count": 48, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "13200" ] }, "execution_count": 48, "metadata": {}, "output_type": "execute_result" } ], "source": [ "covers = regex_covers(winners, losers)\n", "len(covers)" ] }, { "cell_type": "code", "execution_count": 49, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "90" ] }, "execution_count": 49, "metadata": {}, "output_type": "execute_result" } ], "source": [ "covers2, partial = simplify_covers(covers)\n", "len(covers2)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "So the total number of regexes is increased almost 10-fold, but after simplification the number is only double what it was before. (To put it another way, `simplify_covers` eliminated 99.3% of the parts.) That's not too bad; let's add *more* components.\n", "\n", "# New Parts: Longer Ones\n", "\n", "Previously we generated parts of length up to 4 characters. Why not say \"[we're doing 5](http://www.theonion.com/articles/fuck-everything-were-doing-five-blades,11056/)\"? The implementation is easy:\n", "\n" ] }, { "cell_type": "code", "execution_count": 50, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "SUBPARTS = 5 # Maximum length of a subpart\n", "\n", "def subparts(word):\n", " \"Return a set of subparts of word, consecutive characters up to length 5.\"\n", " return set(word[i:i+1+s] for i in range(len(word)) for s in range(SUBPARTS)) " ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "But how many more regex components does this give us?" ] }, { "cell_type": "code", "execution_count": 51, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "39537" ] }, "execution_count": 51, "metadata": {}, "output_type": "execute_result" } ], "source": [ "covers = regex_covers(winners, losers)\n", "len(covers)" ] }, { "cell_type": "code", "execution_count": 52, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "112" ] }, "execution_count": 52, "metadata": {}, "output_type": "execute_result" } ], "source": [ "covers2, partial = simplify_covers(covers)\n", "len(covers2)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "In the end the longer parts add only 22 new components, rejecting nearly 40,000 other parts. It is time to benchmark again. Remember our previous best was Branch and Bound with 100,000 calls, which yielded 1669 total characters in 170 seconds." ] }, { "cell_type": "code", "execution_count": 53, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 1000 calls, 47: \"i.+o|o.*o|a.a|po|a.t|j|bu|ce|ay.|ma|r.i|n ...\"\n", "lose(34):win(34) 1000 calls, 56: \"r.*y|i.e*$|^s|go|d..e|^f|n.*k|k.+g|hu|rk| ...\"\n", "boy(10):girl(10) 29 calls, 11: \"a.$|de|c|as\"\n", "girl(10):boy(10) 23 calls, 9: \"a$|^m*..i\"\n", "drug(10):city(10) 85 calls, 15: \"o.$|x|ir|f|q|^e\"\n", "city(10):drug(10) 45 calls, 11: \"ri|a.+e|h|k\"\n", "foo(21):bar(21) 1 calls, 3: \"foo\"\n", "bar(21):foo(21) 1000 calls, 23: \"^...a|k|...n|ld|b|ar|or\"\n", "wars(6):trek(9) 23 calls, 7: \" T|P.*E\"\n", "trek(9):wars(6) 169 calls, 12: \"I.?S|RA| F|Y\"\n", "noun(100):adj(98) 1000 calls, 161: \"^wa|l.v|m.+n|me?$|.i.*d|....o|an*.e$|..k$ ...\"\n", "adj(98):noun(100) 1000 calls, 140: \"e.+y|^..l*$|l.*s|rs?e$|a.l|ei?t|st$|en$|f ...\"\n", "noun(100):verb(94) 1000 calls, 168: \"h.+g|mp*.n|p.*r|..h.|mb*e|ea?s|^k?i|.ne|. ...\"\n", "verb(94):noun(100) 1000 calls, 162: \"rr|tar|o.b|^..p?l|^f?..$|buy|f$|^fi|as*k| ...\"\n", "rand(58):built(147) 1000 calls, 72: \"ee|^_.*n|a.p|ia|an*d.|^_.?e|tst|e._+$|o.c ...\"\n", "built(147):rand(58) 1000 calls, 130: \"^rang|r...$|c.*t|ra*.i|^l*i|al*s|ug|^m?a| ...\"\n", "dog(100):cat(91) 1000 calls, 43: \"E.+S$|I.*S$|H.*N.S|.HI|G.?S|TES|.SO|W |O.D.\"\n", "cat(91):dog(100) 1000 calls, 105: \"J.V|RA*$|R.*A.$|LD?$|N.*X|M$|M...$|E.*O.$ ...\"\n", "movie(100):tv(97) 1000 calls, 148: \" TH.+N| A*. |R...R|GR?O|IS?.$|A.C*E$|^GR| ...\"\n", "tv(97):movie(100) 1000 calls, 148: \"4|HT?.W|..CH*I|XI$|PO*R|R..AN|MAS|..AY.|O ...\"\n", "sci(50):star(50) 1000 calls, 71: \"AN?L..|T.V?.N|RL?.S|N.*RE|.S.+H|LER|.KA|G ...\"\n", "star(50):sci(50) 1000 calls, 74: \"U.*R.|GR|LO.|F.+D|I.Y*N| T*R|G.*Y|LES?$|E ...\"\n", "CPU times: user 4min 23s, sys: 2 s, total: 4min 25s\n", "Wall time: 4min 25s\n" ] }, { "data": { "text/plain": [ "1616" ] }, "execution_count": 53, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=1000)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We reduced the total characters by about 4%, although it did take longer, even with only 1,000 calls. And notice we no longer need `'^HAVANESE$'`; instead we have `'H.*N.S'`, which saves 4 characters, and, look how many breeds it matches:" ] }, { "cell_type": "code", "execution_count": 54, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "{'AFGHAN HOUNDS',\n", " 'BASSET HOUNDS',\n", " 'BLOODHOUNDS',\n", " 'CHINESE CRESTED',\n", " 'CHINESE SHAR-PEI',\n", " 'DACHSHUNDS',\n", " 'HAVANESE',\n", " 'IRISH WOLFHOUNDS',\n", " 'ITALIAN GREYHOUNDS',\n", " 'TREEING WALKER COONHOUNDS'}" ] }, "execution_count": 54, "metadata": {}, "output_type": "execute_result" } ], "source": [ "matches('H.*N.S', dogs)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Let's continue benchmarking:" ] }, { "cell_type": "code", "execution_count": 55, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 10000 calls, 46: \"i.+o|j|bu|oo|a.t|n.o*e|ma|po|ie.|ay.|e.?a ...\"\n", "lose(34):win(34) 10000 calls, 55: \"r.*y|i.e*$|^s|go|de|do|^f|la.$|al|n.*k|k. ...\"\n", "boy(10):girl(10) 29 calls, 11: \"a.$|de|c|as\"\n", "girl(10):boy(10) 23 calls, 9: \"a$|^m*..i\"\n", "drug(10):city(10) 85 calls, 15: \"o.$|x|ir|f|q|^e\"\n", "city(10):drug(10) 45 calls, 11: \"ri|a.+e|h|k\"\n", "foo(21):bar(21) 1 calls, 3: \"foo\"\n", "bar(21):foo(21) 6151 calls, 23: \"^...a|k|...n|ld|b|ar|or\"\n", "wars(6):trek(9) 23 calls, 7: \" T|P.*E\"\n", "trek(9):wars(6) 169 calls, 12: \"I.?S|RA| F|Y\"\n", "noun(100):adj(98) 10000 calls, 160: \"^wa|l.v|m.+n|me?$|.i.*d|....o|an*.e$|..k$ ...\"\n", "adj(98):noun(100) 10000 calls, 136: \"e.+y|^..l*$|l.*s|rs?e$|a.l|ei?t|st$|en$|f ...\"\n", "noun(100):verb(94) 10000 calls, 167: \"h.+g|mp*.n|p.*r|..h.|mb*e|ea?s|^k?i|.ne|. ...\"\n", "verb(94):noun(100) 10000 calls, 162: \"rr|tar|o.b|^..p?l|^f?..$|buy|f$|^fi|as*k| ...\"\n", "rand(58):built(147) 10000 calls, 69: \"ee|^_.*n|a.p|ia|an*d.|^_.?e|tst|_s|.G|_.o ...\"\n", "built(147):rand(58) 10000 calls, 124: \"^rang|r...$|c.*t|ra*.i|^l*i|al*s|ug|^m?a| ...\"\n", "dog(100):cat(91) 10000 calls, 43: \"E.+S$|I.*S$|H.*N.S|.HI|G.?S|TES|.SO|W |O.D.\"\n", "cat(91):dog(100) 10000 calls, 104: \"J.V|RA*$|R.*A.$|LD?$|N.*X|M$|M...$|E.*O.$ ...\"\n", "movie(100):tv(97) 10000 calls, 148: \" TH.+N| A*. |R...R|GR?O|IS?.$|A.C*E$|^GR| ...\"\n", "tv(97):movie(100) 10000 calls, 148: \"4|HT?.W|..CH*I|XI$|PO*R|R..AN|MAS|..AY.|O ...\"\n", "sci(50):star(50) 10000 calls, 70: \"AN?L..|T.V?.N|RL?.S|N.*RE|.S.+H|LER|.KA|P ...\"\n", "star(50):sci(50) 10000 calls, 73: \"U.*R.|GR|LO.|F.+D|I.Y*N| T*R|G.*Y|AE?.W|E ...\"\n", "CPU times: user 4min 38s, sys: 2 s, total: 4min 40s\n", "Wall time: 4min 40s\n" ] }, { "data": { "text/plain": [ "1596" ] }, "execution_count": 55, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=10000)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We're making good progress. What next? We now have so many parts, that many of the searches do not complete. Suppose one of our first choices was wrong, and the search took a part that does not belong in an optimal solution. We might well spend all our calls on the half of the search tree that keeps the part, never exploring a part of the tree without it. I'd like to alter the search algorithm to get us out of that rut.\n", "\n", "# Searching: Random Restart\n", "\n", "\n", "One way out of the rut is to run the search for a while, then stop it, and run a different search, that explores a different part of the search space. This is called a *random restart search*. How do we get a *different* search when we restart? I can think of two easy things to vary:\n", " \n", "+ The '4' in the `score` function. That is, vary the tradeoff between number of winners matched and number of characters in a regex.\n", "+ The tie-breaker. In case of a tie on `max(covers, key=score)`, Python always picks the first component. Let's make it choose a different one each time.\n", "\n", "The first of these is easy; we can use the `random.choice` function to choose an integer, K, to serve as the tradeoff factor. The second is easy too. We could write an alternative to the `max` function, say `max_random_tiebreaker`. That would work, but an easier approach is to build the tiebreaker into the `score` function. In addition to awarding points for matching winners, and subtracting a point for each character in the solution, we will have `score` add in a random number. We'll call this the \"fuzz factor\" and use the variable `F` to determine how big it is. If the fuzz factor is a random number between 0 and 1, then all it does is serve as a tiebreaker. But if it is a random number that can be larger than 1, then sometimes it will cause `max` to pick a best part that does not have quite the best score. We're not sure how much randomness is best, so we'll let the values of `K` and `F` vary from one choice to the next." ] }, { "cell_type": "code", "execution_count": 56, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [], "source": [ "def bb_findregex(winners, losers, calls=10000, restarts=10):\n", " \"Find the shortest disjunction of regex components that covers winners but not losers.\"\n", " bb = BranchBoundRandomRestart(winners, calls)\n", " covers = eliminate_dominated(regex_covers(winners, losers))\n", " for _ in range(restarts):\n", " bb.calls = calls\n", " bb.search(covers.copy())\n", " if bb.calls > 0: # If search was not cut off, we have optimal solution\n", " return bb \n", " return bb\n", "\n", "class BranchBoundRandomRestart(BranchBound):\n", " def search(self, covers, partial=None):\n", " \"\"\"Recursively extend partial regex until it matches all winners in covers.\n", " Try all reasonable combinations until we run out of calls.\"\"\"\n", " if self.calls <= 0: \n", " return partial, covers\n", " self.calls -= 1\n", " covers, partial = simplify_covers(covers, partial)\n", " if not covers: # Nothing left to cover; solution is complete\n", " self.cheapest = min(partial, self.cheapest, key=len)\n", " elif len(OR(partial, min(covers, key=len))) < len(self.cheapest):\n", " # Try with and without the greedy-best component\n", " K = random.choice((2, 3, 4, 4, 4, 5, 6))\n", " F = random.choice((0.1, 0.1, 2.0))\n", " def score(c): return K * len(covers[c]) - len(c) + random.uniform(0., F)\n", " best = max(covers, key=score) # Best component\n", " covered = covers[best] # Set of winners covered by r\n", " covers.pop(best)\n", " self.search({c:covers[c]-covered for c in covers}, OR(partial, best))\n", " self.search(covers, partial)\n", " return self.cheapest" ] }, { "cell_type": "code", "execution_count": 57, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 100 calls, 49: \"i.+o|o.*o|.f|ce|a.a|po|bu|ay.|ma|n.e|j|an ...\"\n", "lose(34):win(34) 100 calls, 52: \"r.*y|^d|^s|go|m.+a|^f|....k|^.?la|ki*..$| ...\"\n", "boy(10):girl(10) 29 calls, 11: \"a.$|c|de|as\"\n", "girl(10):boy(10) 21 calls, 9: \"a$|^m*..i\"\n", "drug(10):city(10) 91 calls, 15: \"o.$|x|ir|f|q|^e\"\n", "city(10):drug(10) 49 calls, 11: \"ri|h|a.+e|k\"\n", "foo(21):bar(21) 1 calls, 3: \"foo\"\n", "bar(21):foo(21) 100 calls, 23: \"..r..|^...a|k|A|ld|...n\"\n", "wars(6):trek(9) 23 calls, 7: \" T|P.*E\"\n", "trek(9):wars(6) 100 calls, 12: \"I.?S|TI|H |Y\"\n", "noun(100):adj(98) 100 calls, 160: \"^wa|l.v|m.+n|me?$|....o|.i.*d|ar*c.$|wo|. ...\"\n", "adj(98):noun(100) 100 calls, 128: \"e.+y|^o*..$|l.*s|ll|rs?e$|ei?t|en$|st$|fa ...\"\n", "noun(100):verb(94) 100 calls, 163: \"h.+g|mo?.n|p.*r|..h.|mb*e|t.*o|.ne|^k?i|f ...\"\n", "verb(94):noun(100) 100 calls, 161: \"rr|tar|o.b|^..p?l|^s*..$|f$|buy|as*k|r.ad ...\"\n", "rand(58):built(147) 100 calls, 69: \"ee|^_.*n|a.p|ia|an*d.|^_.?e|tst|_s|_a?.o| ...\"\n", "built(147):rand(58) 100 calls, 119: \"^rang|r...$|c.*t|Wa|^d?i|al*s|ug|^m?a|o.* ...\"\n", "dog(100):cat(91) 100 calls, 43: \"E.+S$|I.*S$|H.*N.S|.HI|G.?S|.SO|W |TES|O.D.\"\n", "cat(91):dog(100) 100 calls, 97: \"J.V|RA*$|T$|LI*$|AN?$|N.*X|M$|F$|S.+E$|E. ...\"\n", "movie(100):tv(97) 100 calls, 144: \" TH.+N|R...R| A*. |GO|UC*. |^N|A.C*E$|^GR ...\"\n", "tv(97):movie(100) 100 calls, 148: \"4|HT?.W|..CH*I|XI$|PO*R|R..AN|MAS| .E.?E| ...\"\n", "sci(50):star(50) 100 calls, 67: \"AN?L..|T.V?.N|.S.+H|.KA|IL?.O|N.*RE|OS|LE ...\"\n", "star(50):sci(50) 100 calls, 73: \"U.*R.|GR|LO.|F.+D|I.Y*N| T*R|G.*Y| M*.T|E ...\"\n", "CPU times: user 4min 39s, sys: 2.33 s, total: 4min 41s\n", "Wall time: 4min 41s\n" ] }, { "data": { "text/plain": [ "1564" ] }, "execution_count": 57, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=100) " ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Remember, when it says \"100 calls\" here, it really means 1,000 calls, because we are doing 10 random restarts. This looks very promising; even with only 100 calls per restart, we're doing better than 100,000 calls without restarts. Let's continue:" ] }, { "cell_type": "code", "execution_count": 58, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 1000 calls, 46: \"i.+o|o.*o|bu|a.t|j|ma|po|ie.|n.e|ay.|ar*d ...\"\n", "lose(34):win(34) 1000 calls, 55: \"r.*y|i.e*$|^s|go|de|^f|do|la.$|al|k.+g|hu ...\"\n", "boy(10):girl(10) 31 calls, 11: \"a.$|de|c|as\"\n", "girl(10):boy(10) 21 calls, 9: \"a$|^m*..i\"\n", "drug(10):city(10) 89 calls, 15: \"o.$|x|ir|f|q|^e\"\n", "city(10):drug(10) 41 calls, 11: \"ri|a.+e|h|k\"\n", "foo(21):bar(21) 1 calls, 3: \"foo\"\n", "bar(21):foo(21) 1000 calls, 23: \"^...a|k|...n|ld|b|or|ar\"\n", "wars(6):trek(9) 33 calls, 7: \" T|P.*E\"\n", "trek(9):wars(6) 153 calls, 12: \"I.?S|RA| F|Y\"\n", "noun(100):adj(98) 1000 calls, 159: \"^wa|l.v|m.+n|me?$|....o|.i.*d|an*.e$|..k$ ...\"\n", "adj(98):noun(100) 1000 calls, 128: \"e.+y|^o*..$|l.*s|ll|rs?e$|ei?t|st$|en$|fa ...\"\n", "noun(100):verb(94) 1000 calls, 162: \"h.+g|mp*.n|p.*r|..h.|mb*e|^k?i|.ne|or.?$| ...\"\n", "verb(94):noun(100) 1000 calls, 159: \"rr|tar|o.b|^..p?l|^s*..$|f$|buy|as*k|r.ad ...\"\n", "rand(58):built(147) 1000 calls, 69: \"ee|ia|^_.*n|a.p|an*d.|^_.?e|tst|_a?.o|ga| ...\"\n", "built(147):rand(58) 1000 calls, 119: \"^rang|r...$|c.*t|Wa|^d?i|al*s|ug|o.*p..|Y ...\"\n", "dog(100):cat(91) 1000 calls, 43: \"E.+S$|I.*S$|H.*N.S|.HI|G.?S|TES|.SO|W |O.D.\"\n", "cat(91):dog(100) 1000 calls, 96: \"J.V|RA*$|T$|LD?$|AN?$|N.*X|M$|Y$|S.+E$|M. ...\"\n", "movie(100):tv(97) 1000 calls, 139: \" TH.+N| A*. |R...R|GO|UC*. |^N|NC.$|A.NI| ...\"\n", "tv(97):movie(100) 1000 calls, 148: \"4|HT?.W|..CH*I|XI$|PO*R|..AY.|O.+L.$|R..A ...\"\n", "sci(50):star(50) 1000 calls, 67: \"AN?L..|T.V?.N|.S.+H|.KA|IL?.O|N.*RE|OS|NN ...\"\n", "star(50):sci(50) 1000 calls, 73: \"U.*R.|GR|LO.|F.+D|I.+H$| T*R|G.*NE| M*.T| ...\"\n", "CPU times: user 4min 56s, sys: 3.13 s, total: 4min 59s\n", "Wall time: 4min 59s\n" ] }, { "data": { "text/plain": [ "1554" ] }, "execution_count": 58, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=1000)" ] }, { "cell_type": "code", "execution_count": 59, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "win(34):lose(34) 10000 calls, 46: \"i.+o|o.*o|bu|a.t|j|ma|po|n.e|ay.|ar*d|e.? ...\"\n", "lose(34):win(34) 10000 calls, 52: \"^d|r.*y|^s|go|m.+a|^f|^.?la|....k|ki*..$| ...\"\n", "boy(10):girl(10) 29 calls, 11: \"a.$|de|c|as\"\n", "girl(10):boy(10) 21 calls, 9: \"a$|^m*..i\"\n", "drug(10):city(10) 105 calls, 15: \"x|o.$|ir|f|q|^e\"\n", "city(10):drug(10) 39 calls, 11: \"ri|a.+e|h|k\"\n", "foo(21):bar(21) 1 calls, 3: \"foo\"\n", "bar(21):foo(21) 6049 calls, 23: \"^...a|k|...n|ld|b|ar|or\"\n", "wars(6):trek(9) 23 calls, 7: \" T|P.*E\"\n", "trek(9):wars(6) 147 calls, 12: \"I.?S|TI|H |Y\"\n", "noun(100):adj(98) 10000 calls, 158: \"^wa|l.v|m.+n|me?$|....o|.i.*d|a.e$|..k$|^ ...\"\n", "adj(98):noun(100) 10000 calls, 128: \"e.+y|^o*..$|ll|l.*s|rs?e$|ei?t|en$|i..l|l ...\"\n", "noun(100):verb(94) 10000 calls, 163: \"h.+g|mp*.n|p.*r|..h.|mb*e|^k?i|.ne|.t.*y| ...\"\n", "verb(94):noun(100) 10000 calls, 157: \"rr|tar|o.b|^..p?l|^s*..$|f$|buy|as*k|r.ad ...\"\n", "rand(58):built(147) 10000 calls, 67: \"ee|ia|^_.*n|a.p|and|^_.?e|tst|_a?.o|ga|.G ...\"\n", "built(147):rand(58) 10000 calls, 121: \"^rang|r...$|c.*t|Wa|al*s|ug|^l*i|o.*p..|Y ...\"\n", "dog(100):cat(91) 10000 calls, 43: \"E.+S$|I.*S$|H.*N.S|.HI|G.?S|TES|.SO|W |O.D.\"\n", "cat(91):dog(100) 10000 calls, 96: \"J.V|RA*$|T$|LD?$|AN?$|N.*X|M$|M...$|Y$|M. ...\"\n", "movie(100):tv(97) 10000 calls, 141: \" TH.+N| A*. |R...R|GR?O|UC*. |A.C*E$|^GR| ...\"\n", "tv(97):movie(100) 10000 calls, 148: \"4|HT?.W|..CH*I|XI$|PO*R|..AY.|R..AN|MAS|O ...\"\n", "sci(50):star(50) 10000 calls, 67: \"AN?L..|T.V?.N|.S.+H|.KA|OS|NN|I.O|OD|^P|N ...\"\n", "star(50):sci(50) 10000 calls, 72: \"U.*R.|GR|LO.|I.+H$|F.+D| T*R|G.*Y|YN|^B|I ...\"\n", "CPU times: user 8min 3s, sys: 11.9 s, total: 8min 15s\n", "Wall time: 8min 15s\n" ] }, { "data": { "text/plain": [ "1550" ] }, "execution_count": 59, "metadata": {}, "output_type": "execute_result" } ], "source": [ "%time bbenchmark(calls=10000)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Just One More Thing: Negative Lookahead\n", "----\n", "\n", "In the `foo` versus `bar` example, we have a big asymmetry in the solution lengths: three letter for `'foo'` compared to 23 characters in the other direction. But if you are a real [regular expression superhero](https://xkcd.com/208/), then you might know about [*negative lookahead assertions*](http://docs.python.org/2/howto/regex.html#lookahead-assertions) and you could solve `bar` versus `foo` like this: " ] }, { "cell_type": "code", "execution_count": 60, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 60, "metadata": {}, "output_type": "execute_result" } ], "source": [ "not_foo = '^(?!.*foo)'\n", "not mistakes(not_foo, bar, foo)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Whoa—what just happened there? The form `'^(?!.*foo)'` means \"starting from the beginning of the line, look ahead for `'.*foo'` (that is, any number of characters followed by `'foo'`). If it is there, then fail, else succeeed.\" That's just what we need to match all the non-foo strings in the `bar` collection. Let's apply this idea to the complete benchmark and see how many characters we save. We'll use the `SOLUTION` dict that was compiled by the previous call to `benchmark`:" ] }, { "cell_type": "code", "execution_count": 61, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "CPU times: user 15.8 ms, sys: 291 µs, total: 16.1 ms\n", "Wall time: 16 ms\n" ] }, { "data": { "text/plain": [ "1429" ] }, "execution_count": 61, "metadata": {}, "output_type": "execute_result" } ], "source": [ "def consider_negative_lookahead(W, L): \n", " \"Return either SOLUTION[W, L] or negative lookup of SOLUTION[L, W], whichever is shorter.\"\n", " solution = min(SOLUTION[W, L], '^(?!.*(' + SOLUTION[L, W] + '))',\n", " key=len)\n", " assert not mistakes(solution, W, L)\n", " return solution\n", " \n", "%time sum(len(consider_negative_lookahead(W, L)) for (W, _, _, L) in EXAMPLES)" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "Very nice! Almost a 10% improvement, and it took almost no additional time at all. \n", "\n", "# Summary of Results\n", "\n", "Here is a plot of results. Note that every time you re-run this notebook, the timing and the exact number of characters will vary a little; these numbers reflect rrsults from a previous run.\n" ] }, { "cell_type": "code", "execution_count": 62, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "data": { "image/png": "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\naaJjx44ttL6EhAS977778qX95z//0Ro1auiRI0c0NTVVR44cqY0aNdKQkBCNjIzUBQsWqKrqM888\no6k4Gp4AABn+SURBVA0bNtTAwEBt3ry5vvPOO6463nzzTa1fv77WrFlTP/74Yz18+LBGR0drYGCg\ntm7dWt966y318fHRnJwcVVWNjo7W9957L187vvrqK23VqpWGhobq448/7rb9y5cv19tuu821vn//\nfhURFRH18fFREdGIiAhVVZ0+fbqOGjUq3/YTJkxwlc9dJk6c6Mr//PPPtU2bNurv76833nijHjhw\nQFVVd+7cqR06dMhX19q1awvs+8Ybb3TlJyUlaXR0tPr7+2ubNm10zZo1+bafO3euNmnSRAMCAnTw\n4MGakpLiyrvw+zl+/Lh27txZf/vb3+q5c+d08uTJ+uSTT7r9jsrDpfybMaYyW7t2bb7znPO3WuJz\ntKgX3/vtfASwVFU7ikhH4HPglDO7EY4r+m6qevSC7dYCTwLJwBeq/7+9e4/P6UoXOP57ookmEpK4\nNUJQHa26H5cWbQUd7QyqqNvUrZzWMLTTqVsrmTIdzmhLT9Gehipl1JSpYTDV4gg6p8O0LiGUSpMg\njLZEmsQgkuf88e68zZu8IeqNNPJ8P598vO9aa6+99kq2vfbaa6+lTZzwwUBnVf2ll32pt2Oxtc3L\nl/vuu4833njDYxS9Nz169GD8+PFeH4Vcq5dffpmzZ8/+KCbfuXjxIq1atWLHjh3utzduNDtnjCkf\nnHP16pOsFOOGPQJQ1f2A+/01EUkG2qjqWRGpAaSraq6I3A78BPhKVc+JyHcicg+wCxgKFH2HzNw0\nPvnkkxKli46OLtGI/ZJo2LAhvXv39kle16ty5cocOnSorIthjKkASq0HQERWAJ2B6sDXwG9VdXGB\n+K+Atk4DoC/wOyAHyHPSbnDStQGWAIHA31S16CwyWA+AMb5i54wx5cP19gCU6iOAG8kaAMb4hp0z\nxpQP19sAsJkAjTHGmArIGgDGGGNMBWQNAGOMMaYCsgaAMcYYUwFZA8CYHyh/lcOSOnjwIO3atSvF\nEpVMQkICnTp1KutiGGPKmDUAylCDBg0ICgoiJCSE8PBwevbsyYkT3898PGLECCpXrkxISAhVq1al\nbdu27uV5vZk2bRr+/v6EhIQQGhrKvffey44dO667nH5+fnz11VfXlUd0dDSLFi0qNj4lJQU/P78i\n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\nD6cAAAAASUVORK5CYII=\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Algorithm Style Times Total character counts\n", "DATA = [('Greedy', 'gD-', [6], [1740]),\n", " ('BB (1/10/100K)', 'bo-', [8, 21, 196], [1676, 1674, 1669]),\n", " ('BB + Parts (1/10K)', 'kd-', [272, 288], [1595, 1587]),\n", " ('BB Restart (1/10/100K)', 'rs-', [289, 303, 493], [1560, 1556, 1547]),\n", " ('BB Restart NegLook (100K)','m*-', [493], [1426])]\n", "\n", "def display(data=DATA):\n", " fig = plt.figure()\n", " ax = fig.add_subplot(111)\n", " for (label, line, times, counts) in data:\n", " plt.plot(times, counts, line, label=label)\n", " x, y = times[-1], counts[-1]\n", " offset = (-22, -15) if line in ('rs-', 'm*-') else (10, -5)\n", " ax.annotate(str(y), xy=(x, y), xytext=offset, textcoords='offset points')\n", " plt.xlabel('Time (seconds)'); plt.ylabel('Solution size (total chars)')\n", " plt.legend(loc='lower left');\n", "\n", "display()" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We've made great strides, decreasing the total solution length by 20%. (It is up to you whether that 20% improvement is worth the increase in time from 6 seconds to 8 minutes.)\n", "\n", "# Profiling Again\n", "\n", "Now where does the time go? Let's check again:" ] }, { "cell_type": "code", "execution_count": 63, "metadata": { "button": false, "collapsed": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ " 59623899 function calls (59278679 primitive calls) in 36.067 seconds\n", "\n", " Ordered by: cumulative time\n", "\n", " ncalls tottime percall cumtime percall filename:lineno(function)\n", " 1 0.000 0.000 36.067 36.067 {built-in method builtins.exec}\n", " 1 0.000 0.000 36.067 36.067 :1()\n", " 1 0.002 0.002 36.067 36.067 :21(findregex)\n", " 1 0.072 0.072 36.066 36.066 :1(bb_findregex)\n", "100178/10 0.781 0.000 24.877 2.488 :13(search)\n", " 100000 0.593 0.000 20.145 0.000 :1(simplify_covers)\n", " 209152 2.074 0.000 11.561 0.000 :1(eliminate_dominated)\n", " 1 0.007 0.007 10.413 10.413 :1(regex_covers)\n", " 4047977 2.941 0.000 8.916 0.000 {built-in method builtins.any}\n", " 1 0.104 0.104 8.110 8.110 :9()\n", " 209151 0.747 0.000 8.080 0.000 :1(select_necessary)\n", " 89666 0.043 0.000 8.006 0.000 re.py:222(compile)\n", " 89666 0.533 0.000 7.963 0.000 re.py:278(_compile)\n", " 89666 0.449 0.000 7.330 0.000 sre_compile.py:531(compile)\n", " 18054570 4.510 0.000 4.745 0.000 :10()\n", " 89666 0.335 0.000 3.693 0.000 sre_parse.py:819(parse)\n", " 209151 0.801 0.000 3.453 0.000 __init__.py:505(__init__)\n", " 209151 1.187 0.000 3.322 0.000 :5()\n", " 89666 0.161 0.000 2.947 0.000 sre_compile.py:516(_code)\n", " 89666 0.187 0.000 2.930 0.000 sre_parse.py:429(_parse_sub)\n", " 50084 0.587 0.000 2.783 0.000 {built-in method builtins.max}\n", " 209152 1.339 0.000 2.649 0.000 {built-in method builtins.sorted}\n", " 209151 0.408 0.000 2.626 0.000 __init__.py:574(update)\n", " 89666 1.184 0.000 2.626 0.000 sre_parse.py:491(_parse)\n", " 636500 0.910 0.000 2.196 0.000 :26(score)\n", " 1 1.683 1.683 2.164 2.164 :10()\n", " 89666 0.472 0.000 1.407 0.000 sre_compile.py:412(_compile_info)\n", "171350/89666 0.873 0.000 1.369 0.000 sre_compile.py:64(_compile)\n", " 426948 0.469 0.000 1.331 0.000 :1(OR)\n", " 2167485 0.983 0.000 1.311 0.000 :6(signature)\n", " 209151 0.622 0.000 1.310 0.000 {built-in method _collections._count_elements}\n", " 4734318 1.287 0.000 1.287 0.000 :5()\n", " 636500 1.118 0.000 1.180 0.000 random.py:342(uniform)\n", " 1147585 0.351 0.000 1.049 0.000 {built-in method builtins.isinstance}\n", "11387014/11305330 0.956 0.000 0.980 0.000 {built-in method builtins.len}\n", " 444972 0.606 0.000 0.818 0.000 {method 'join' of 'str' objects}\n", " 209151 0.416 0.000 0.698 0.000 abc.py:178(__instancecheck__)\n", " 2988397 0.688 0.000 0.688 0.000 :4()\n", "253034/171350 0.566 0.000 0.684 0.000 sre_parse.py:167(getwidth)\n", " 480786 0.209 0.000 0.605 0.000 sre_parse.py:247(get)\n", " 89666 0.481 0.000 0.481 0.000 {method 'search' of '_sre.SRE_Pattern' objects}\n", " 490104 0.334 0.000 0.478 0.000 sre_parse.py:157(__getitem__)\n", " 570452 0.474 0.000 0.474 0.000 sre_parse.py:226(__next)\n", " 532234 0.368 0.000 0.368 0.000 {built-in method builtins.min}\n", " 2239948 0.317 0.000 0.317 0.000 {method 'append' of 'list' objects}\n", " 418302 0.282 0.000 0.282 0.000 _weakrefset.py:70(__contains__)\n", " 100168 0.097 0.000 0.270 0.000 random.py:250(choice)\n", " 76784 0.248 0.000 0.248 0.000 :8()\n", " 81684 0.148 0.000 0.241 0.000 sre_compile.py:386(_simple)\n", " 399102 0.153 0.000 0.234 0.000 sre_parse.py:165(append)\n", " 89666 0.145 0.000 0.233 0.000 sre_parse.py:217(__init__)\n", " 1102830 0.213 0.000 0.213 0.000 :6()\n", " 50084 0.195 0.000 0.195 0.000 :30()\n", " 100168 0.111 0.000 0.164 0.000 random.py:220(_randbelow)\n", " 89666 0.098 0.000 0.111 0.000 sre_parse.py:797(fix_flags)\n", " 1 0.018 0.018 0.109 0.109 :7()\n", " 171350 0.107 0.000 0.107 0.000 sre_parse.py:105(__init__)\n", " 171350 0.088 0.000 0.107 0.000 sre_parse.py:276(tell)\n", " 89666 0.102 0.000 0.102 0.000 {built-in method _sre.compile}\n", " 245052 0.080 0.000 0.102 0.000 sre_parse.py:153(__len__)\n", " 38126 0.095 0.000 0.100 0.000 sre_compile.py:391(_generate_overlap_table)\n", " 179332 0.076 0.000 0.096 0.000 sre_compile.py:513(isstring)\n", " 7902 0.016 0.000 0.091 0.000 :19(repetitions)\n", " 89666 0.085 0.000 0.085 0.000 sre_parse.py:70(__init__)\n", " 179332 0.064 0.000 0.082 0.000 sre_parse.py:75(groups)\n", " 636500 0.062 0.000 0.062 0.000 {method 'random' of '_random.Random' objects}\n", " 7902 0.047 0.000 0.061 0.000 :24()\n", " 171350 0.048 0.000 0.048 0.000 sre_parse.py:242(match)\n", " 76784 0.047 0.000 0.047 0.000 :7()\n", " 123976 0.042 0.000 0.042 0.000 {method 'getrandbits' of '_random.Random' objects}\n", " 246020 0.028 0.000 0.028 0.000 {built-in method builtins.ord}\n", " 81684 0.023 0.000 0.023 0.000 sre_parse.py:161(__setitem__)\n", " 1 0.003 0.003 0.022 0.022 :6()\n", " 76384 0.022 0.000 0.022 0.000 {method 'extend' of 'list' objects}\n", " 2433 0.006 0.000 0.016 0.000 :56(dotify)\n", " 89666 0.016 0.000 0.016 0.000 {method 'items' of 'dict' objects}\n", " 7902 0.014 0.000 0.014 0.000 :23()\n", " 61211 0.012 0.000 0.012 0.000 {method 'endswith' of 'str' objects}\n", " 100168 0.011 0.000 0.011 0.000 {method 'bit_length' of 'int' objects}\n", " 50084 0.009 0.000 0.009 0.000 {method 'pop' of 'dict' objects}\n", " 49204 0.009 0.000 0.009 0.000 {method 'get' of 'dict' objects}\n", " 2433 0.006 0.000 0.009 0.000 :59()\n", " 176 0.008 0.000 0.008 0.000 {method 'clear' of 'dict' objects}\n", " 98 0.001 0.000 0.002 0.000 :3(subparts)\n", " 9029 0.002 0.000 0.002 0.000 {method 'startswith' of 'str' objects}\n", " 6431 0.002 0.000 0.002 0.000 :61(replacements)\n", " 3568 0.001 0.000 0.001 0.000 :5()\n", " 1 0.000 0.000 0.001 0.001 :14(pairs)\n", " 1 0.001 0.001 0.001 0.001 :16()\n", " 10 0.000 0.000 0.000 0.000 {method 'copy' of 'dict' objects}\n", " 1 0.000 0.000 0.000 0.000 :3(__init__)\n", " 1 0.000 0.000 0.000 0.000 :73(trivial)\n", " 1 0.000 0.000 0.000 0.000 :5()\n", " 1 0.000 0.000 0.000 0.000 weakref.py:102(remove)\n", " 1 0.000 0.000 0.000 0.000 {method 'disable' of '_lsprof.Profiler' objects}\n", "\n", "\n" ] } ], "source": [ "cProfile.run('findregex(adverbs, nouns)', sort='cumulative')" ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "We see that the majority of the time is in `simplify_covers`, and within that, half the time goes to `eliminate_dominated`. That gives us some ideas of where speedups could be made, but gains will be harder now than before." ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "\n", "# Speculating: Other Ideas\n", "\n", "I'm going to stop here, but I'll briefly mention some other ideas that I didn't get to investigate. Perhaps you can play with some of these, or with other ideas.\n", "\n", "- *Completely different approach*: [Thomas Breuel](https://plus.google.com/118190679520611168174/posts) suggested doing [minimization](http://en.wikipedia.org/wiki/DFA_minimization) of [weighted finite state transducers](http://nbviewer.ipython.org/url/nlpa.iupr.com/resources/nlpa-openfst.ipynb?attredirects=0&create=1).\n", "- *Character classes*: We never considered character classes, such as `'[abc]'`. It is not obvious they would help, but it is possible. Consider the fragment `'ld|la'`, which shows up in one of the solutions. We could replace that with a single component, `'l[da]'`. But we haven't gained anything; both are 5 characters long. If we had had `'l.d|l.c|l.b|l.a'` then the replacement `'l.[a-d]'` would save 8 characters, but I don't see many opportunities like that. It might also be possible to use *negative* character classes, like `l[^y]` to explicitly avoid something in the losers set.\n", "\n", "- *Prefilter parts*: Currently, `regex_covers` generates a huge set of components, then eliminates the ones that match losers (or don't match winners), and then eliminates the ones that are dominated. We could make `regex_covers` faster by not generating components that can't possibly contribute. Suppose we're considering a subpart, say `'ab'`. If it matches no losers, then there is no reason to extend it to a longer subpart, such as `'abc'`, because we know that `'abc'` is dominated by `'ab'`. By filtering out dominated parts before we have to check them, I estimate we should be able to cut the time for `regex_covers` in half, maybe better.\n", "- *Better component choice*: We pick the \"best\" component based on how many winners it covers and how many characters it takes. Maybe we could have a better measure; perhaps taking into account whether it covers winners that are \"easy\" to cover by other regexes, or \"hard\" to cover.\n", "- *Tuning*: We have the two parameters `K` and `F`, which are randomly chosen from a fairly arbitrary distribution. We could measure which values of the parameters perform better and pick those values more often.\n", "- *Post-editing*: We concentrated on the task of generating a solution from scratch; another task is to improve an existing solution. For example, take the set of components in a solution, and see if one component could be dropped—it is possible that all the winners covered by that component might accidentally have been covered by other components, making it unnecessary. Or take all pairs of components, and see if they could be replaced by a shorter set of components.\n", "- *Better bounds*: Branch and Bound search works best if the bounds are tight. If we can recognize early that the path we are on cannot possibly be as good as the best solution found so far then we can cut off search early and save time. But the bound estimate we are using now is a poor one. We estimate the cost of a solution as the cost of the partial solution plus the cost of the shortest component remaining. We use this estimate because all we know for sure is that we need at least one more component. Here's one way to get a better bound by recognizing that in many cases we will need more than one more component. We'll define the following quantities:\n", "\n", " + *P* = the length of the partial solution, plus the \"|\", if needed. So if the partial solution is `None`, then *P* = 0, else *P* is the length plus 1.\n", " + *S* = the length of the shortest regex component in `covers`.\n", " + *W* = the number of winners still in `covers`.\n", " + *C* = the largest number of winners covered by any regex in `covers`.\n", " \n", " The current estimate is *P* + *S*. We can see that a better estimate is *P* + *S* × ceil(*W* / *C*).\n", "\n", "\n", "I hope you had fun seeing how I (and Stefan) attacked this problem; now go out and solve some problems of your own." ] }, { "cell_type": "markdown", "metadata": { "button": false, "deletable": true, "new_sheet": false, "run_control": { "read_only": false } }, "source": [ "\n", "\n", "
\n", "[*Peter Norvig*](http://norvig.com), Feb. 2014" ] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.5.0" } }, "nbformat": 4, "nbformat_minor": 0 }