30:T415,md`# compromise-nouns A #Noun is a thing being discussed in a sentence. In english, nouns can be \`#Singular\` \`#Plural\` or \`#Uncountable\`. With the **[compromise](https://beta.observablehq.com/@spencermountain/nlp-compromise)** [tag-tree](https://observablehq.com/@spencermountain/compromise-tags), a Noun can also be a \`#Person\`, \`#Pronoun\`, or \`#Organization\` Compromise includes a number of utility methods for working with nouns. Nouns can be multiple-words, like "George Costanza", or "United Banana Ltd.". A [verb](https://observablehq.com/@spencermountain/verbs) can become a noun through context, like "the walk", or an [adjective](https://observablehq.com/@spencermountain/compromise-adjectives) can become a noun - usually by adding a suffix - "scrappy -> scrappiness". [Dates](https://observablehq.com/@spencermountain/compromise-dates) can too - "the 2nd Saturday" would be both a #Noun, and a #Date. --- you can get nouns with a [match-statement](https://observablehq.com/@spencermountain/compromise-match): `31:T4c1,html`

#Noun

#Singular

#Person

#FirstName

#MaleName

#FemaleName

#LastName

#Place

#Country

#City

#Region

#Address

#Organization

#SportsTeam

#Company

#School

#ProperNoun

#Honorific

#Plural

#Uncountable

#Pronoun

#Actor

#Activity

#Unit

#Demonym

#Possessive

`32:[] 2e:{"title":"compromise-nouns","cells":[{"id":50,"value":"$30","pinned":false,"hidden":false,"mode":"ojs"},{"id":412,"value":"nlp('let the blossoming of Millhouse begin').match('#Noun').out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":416,"value":"\nor get a noun-phrase with **.nouns()**:","pinned":false,"hidden":false,"mode":"md"},{"id":2,"value":"nlp('let the blossoming of Millhouse begin').nouns().out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":304,"value":"md`\nonce you call \\`.nouns()\\`, you'll have a View with extended methods on it, for working with noun-phrases.\n\n---\n\n### #Noun tag coercion and suggestion\nWhen you give text to compromise, it will try its best to determine the POS tags and grammar of the words.\nSometimes however, you already know what the grammar of the words, and want to override the default tagger.\n\n\n\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":462,"value":"{\n let doc = nlp('bottles')// compromise guesses this is a Verb\n doc.debug()// see the tags like this\n\n //because it's a Verb, this will do nothing, now\n doc.nouns().toSingular()\n \n //instead, co-erce the text to particular Tags\n doc.tag('Plural')\n doc.nouns().toSingular() //now this will work\n \n return doc.text()\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":466,"value":"if you know your input is a noun, but don't know if it's a Singular or Plural, you can do something like this:","pinned":false,"hidden":false,"mode":"md"},{"id":468,"value":"{\n let doc = nlp('walks') // assumed to be a verb\n // tag it as a noun (neither plural or singular)\n doc.tag('Noun') \n // this method will do some plural/singular guesswork\n if (doc.nouns().isPlural()) {\n doc.tag('Plural')\n }\n //now this will work\n return doc.nouns().toSingular().text()\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":471,"value":"### Uncountable nouns\nremember that not all nouns will inflect - and terms like **'peace'** will have the tag `#Uncountable` - this prevents them from being transformed to singular form.\n","pinned":false,"hidden":false,"mode":"md"},{"id":473,"value":"nlp('trousers').json()[0].terms[0].tags //see the tag","pinned":true,"hidden":false,"mode":"ojs"},{"id":477,"value":"nlp('trousers').nouns().toSingular().text() //it doesn't become 'trouser'","pinned":true,"hidden":false,"mode":"ojs"},{"id":482,"value":"The lexicon of Uncountable words can be changed or removed [like any other tag](https://observablehq.com/@spencermountain/compromise-lexicon) in the lexicon:","pinned":false,"hidden":false,"mode":"md"},{"id":486,"value":"{\n let lex= {scissors:'Uncountable'}\n let doc= nlp('scissors', lex).debug()//it now has the #Uncountable tag\n \n doc.nouns().toSingular() //ah, ok cool\n return doc.text()\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":503,"value":"### Manual singular/plural transformation\nFor whatever reason, if you're frustrated at the compromise api, you can call the inflection methods directly, using [nlp.world()](https://observablehq.com/@spencermountain/compromise-world)","pinned":false,"hidden":false,"mode":"md"},{"id":505,"value":"{\n let {methods, model} = nlp.world()\n const { toSingular, toPlural } = methods.two.transform.noun\n\n let a = toSingular('cookies', model)\n let b= toPlural('cookie', model)\n \n return [a, b]\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":480,"value":"remember also that in practice, nouns are often phrases, like 'chocolate cookies', and 'captain of the football team'. Compromise will handle these cases naturally, but ad-hoc method uses will not.","pinned":false,"hidden":false,"mode":"md"},{"id":458,"value":"---\n# **.nouns() API**\nreturn any subsequent terms tagged as a Noun\n","pinned":false,"hidden":false,"mode":"md"},{"id":369,"value":"nlp(`so, do you come to Milwaukee often?`).nouns().out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":308,"value":"md`\n### **.nouns().json()**\noverloaded output with noun metadata\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":365,"value":"nlp(`Milwaukee has certainly had its share of visitors`).nouns().json()[0]","pinned":true,"hidden":false,"mode":"ojs"},{"id":352,"value":"md`\n### **.nouns().adjectives()**\nall adjectives describing these nouns\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":356,"value":"nlp('the big red door').nouns().adjectives().out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":311,"value":"md`\n### **.nouns().toPlural()**\n\\`'football captain' → 'football captains'\\`\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":435,"value":"nlp('the purple dinosaur').nouns().toPlural().all().text()","pinned":true,"hidden":false,"mode":"ojs"},{"id":432,"value":"nlp('i drank a margharita').nouns().toPlural().all().text()","pinned":true,"hidden":false,"mode":"ojs"},{"id":314,"value":"md`\n### **.nouns().toSingular()**\n\\`'turnovers' → 'turnover'\\`\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":437,"value":"nlp('seven swans a swimming').nouns().toSingular().all().text()","pinned":true,"hidden":false,"mode":"ojs"},{"id":317,"value":"md`\n### **.nouns().isPlural()**\nreturn only plural nouns\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":439,"value":"nlp('two turtledoves and a partridge in a pear tree').nouns().isPlural().out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":455,"value":"### **.nouns().isSingular()**\nreturn only singular nouns","pinned":false,"hidden":false,"mode":"md"},{"id":453,"value":"nlp('two turtledoves and a partridge in a pear tree').nouns().isSingular().out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":109,"value":"md`\n---\n## #Noun sub-tags\nThere are different types of nouns in compromise. Any of the below will automatically include **#Noun** as a tag, whenever it is applied`","pinned":false,"hidden":false,"mode":"ojs"},{"id":186,"value":"$31","pinned":false,"hidden":false,"mode":"ojs"},{"id":107,"value":"md`## Inflection (plurals/singulars)\nyou can turn singular noun-phrases plural, and vice-versa:`","pinned":false,"hidden":false,"mode":"ojs"},{"id":5,"value":"{\n let doc = nlp('tied my shoelaces')\n doc.nouns().toSingular()\n return doc.text()\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":32,"value":"{\n let doc=nlp('the last hour')\n doc.nouns().toPlural()\n return doc.text()\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":125,"value":"md`you can know whether a noun is plural/singular by calling **.data()** or **.isPlural()**` ","pinned":false,"hidden":false,"mode":"ojs"},{"id":123,"value":"nlp('All my life I’ve had one dream, to accomplish my many goals.').nouns().isPlural().out('array')","pinned":true,"hidden":false,"mode":"ojs"},{"id":395,"value":"md`\n---\nyou can change the default singular/plural inflections with custom transformations, using a [compromise plugin](https://observablehq.com/@spencermountain/compromise-plugins):\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":396,"value":"{\n nlp.extend((_Doc, world) => {\n world.addPlurals({ neglectee: 'neglecterinos' })\n })\n const doc = nlp('neglectee')\n return doc.nouns().toPlural().text()\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":136,"value":"nlp('before the hour is up').nouns().json({terms:false})[0]","pinned":false,"hidden":false,"mode":"ojs"},{"id":143,"value":"md`# Demo\n\npull-in a wikipedia article and run it through nlp-compromise, to grab all the nouns:\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":235,"value":"viewof article=html``","pinned":false,"hidden":false,"mode":"ojs"},{"id":149,"value":"{\n //get the wikipedia plaintext with wtf_wikipedia\n let text = await wtf.fetch(article).then(doc=>doc.plaintext())\n //get all the nouns from the text\n let nouns = nlp(text).nouns()\n //sort them by frequency\n let res = nouns.out('topk')\n // show just the top\n res=res.sort((a,b)=> a.count < b.count).slice(0, 15)\n return JSON.stringify(res, null, 2)\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":179,"value":"md`\n----\n\n### See also:\n* **[verbs](https://observablehq.com/@spencermountain/verbs)**\n* **[adjectives](https://observablehq.com/@spencermountain/compromise-adjectives)**\n* **[numbers](https://observablehq.com/@spencermountain/compromise-values)**\n* **[dates](https://observablehq.com/@spencermountain/compromise-dates)**\n\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":347,"value":"style = html``","pinned":false,"hidden":false,"mode":"ojs"},{"id":167,"value":"wtf = require(\"wtf_wikipedia\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":171,"value":"nlp =require('compromise')","pinned":false,"hidden":false,"mode":"ojs"},{"id":340,"value":"nlp.version","pinned":false,"hidden":false,"mode":"ojs"}],"files":"$W32","stdlib":"1","titling":"auto"}