Click here to Skip to main content
Click here to Skip to main content

Having fun with MIT's ConceptNet 2.1 in C#.

, 21 Feb 2006
Rate this:
Please Sign up or sign in to vote.
A ConceptNet .Net Utility Class Library.

Sample Image - cndemoscreen.jpg


I first learned about Hugo Liu's research around three years ago when I was looking into NLP, commonsense data, artifical intelligence code and theory. His work, and others at MIT, is debatably the latest and greatest in today's research and very useful, at least informative, for any program designer. Most of the projects available from MIT are not written in Microsoft Visual Studio .Net and I am attempting to make use of ConceptNet for educational, research purposes, and just to have fun with the technology involved.

What is ConceptNet?

ConceptNet¹ is a commonsense knowledgebase, composed mainly from the Open Mind Project, written and put together by Hugo Liu and Push Singh (Media Laboratory Massachusetts Institute of Technology). ConceptNet 2.1 (current version at the time of this composition) also includes MontyLingua, a natural-language-processing package. ConceptNet is written in Python but it's commonsense knowledgebase is stored in text files. To read more specific details about the complete overview of ConceptNet, read Liu and Singh's outstanding paper (pdf).

What is so Unique about ConceptNet?

Unlike other projects like WordNet or Cyc, ConceptNet is based more on Context. ConceptNet makes it possible, within the limit's of it's knowledgebase, to allow a computer to understand new concepts or even unknown concepts by using conceptual correlations called Knowledge-Lines (K-Lines: a term introduced by Minsky, cf. The Society of Mind (1987)). K-Lines may be thought of a list of previous knowledge about a subject or task. ConceptNet actually puts these K-Lines together using it's twenty relationship types that fall into eight categories (including K-Lines)to form a network of data to simulate conceptual reasoning. What really makes all this possible is ConceptNet's Relational Ontology (the eight categories and twenty relationship types).

ConceptNet is structured around MIT's Open Mind Common Sense Project knowledge base. ConceptNet uses it's data in two processes: The Normalization Process and the Relaxation Process. The Normalization Process involves all the predicate to get filtered and undergo lexical distillation (Verbs and Nouns are reduced to their basic baseforms). Also ConceptNet removes determiners("a", "the", etc.) and modals("may", "could", "will", etc) in this stage. It also uses Parts Of Speech Tagging to validate well structured word orders. (The Normalization Process is not demonstrated in this demo. Please feel free to use your own POS Taggers with this Class Library) The Relaxation Process raises or "Lifts" heavily weighted common sense predicate nodes (one line from the predicate file(s)) and duplicate nodes are merged. This is reflected in each predicate's "f" and "i" metadata tags. Where f equals the number of utterances and i equals the number of of times inferred.

ConceptNet's Relational Ontology

ConceptNet's power of linking subjects together is attributed to twenty relationship types defined by it's Relational Ontology. Here is 2.1's twenty relationship types and eight categories:

(Courtesy Hugo Liu and Push Singh, ConceptNet: A Practical Commonsense Reasoning Toolkit)
• K-Lines: ConceptuallyRelatedTo, ThematicKLine, SuperThematicKLine
• Things: IsA, PartOf, PropertyOf, De.nedAs, MadeOf
• Spatial: LocationOf
• Events: SubeventOf, PrerequisiteEventOf, First-SubeventOf, LastSubeventOf
• Causal: EffectOf, DesirousEffectOf
• Affective: MotivationOf, DesireOf
• Functional: CapableOfReceivingAction, UsedFor
• Agents: CapableOf

Example lines from ConceptNet's 2.1 predicate files:
(UsedFor "ball" "throw" "f=4;i=0;")
(LocationOf "popcorn" "at movie" "f=7;i=0;")
(CapableOfReceivingAction "film" "place on reel" "f=2;i=0;")
(IsA "guitar" "musical instrument with string" "f=2;i=0;")
(SubeventOf "talk" "debate" "f=2;i=0;")
(CapableOf "person" "write book" "f=11;i=1;")
(MotivationOf "audition for part" "act in play" "f=2;i=0;")
(PropertyOf "bacteria" "small" "f=2;i=0;")

Let's get started and get the fun rolling!

What is Needed and Where to download it...

Again, please remember that ConceptNet 2.1 is written in the Python programming language and not C# but it's commonsense knowledgebase data is in text file format totalling around 96mb when uncompressed. You must download the ConceptNet text files by agreeing to it's user agreement (this of course goes for all of the projects listed below for download) and then downloading the entire ConceptNet Python Project.

ConceptNet 2.1 w/MontyLingua (28mb total download) - Required for this article's Class Library demo.

Download Standard Python Software - Optional. Python 2.4.2 Windows installer may be found on that page.

Download IronPython Beta 3 - Optional. It is an implementation of the Python language targeted at .Net and WinFX/Mono. (I am currently writing a short demo app to run the ConceptNet Mini-Browser using IronPython)

My VS.Net C# ConceptNet Class Library

This is a very simple No-Fills Class Library written in MS VS.Net. I have quickly thrown it together mostly because I just downloaded ConceptNet for the first time yesterday and noticed a shortage of VS.Net friendly code. For some reason, I don't remember there being a public download of ConceptNet before, which I may be mistaken, however I have known about this project for some time. It's papers have been available via MIT.
There are two projects in the solution ConceptNet Demo App and ConceptNetUtils. ConceptNetUtils is the ConceptNet Class Library and consists of three Classes: FoundList, Misc, Search.

Holds search result data in an index format. 
Access: Public
Base Classes: Object
   Members Description   
    protected string[] LineFound //Holds the strings.
    static public int size = 999;//This can hold up to 999
                                 //data strings.
    public string this[]//Holds string data.
    Count() //Returns int count of non "" strings
             //(populated indexes). 
    Reset() //Resets data to null.
    public int get_f(int index)  //Returns int of the 
            //f metadata in predicate string line(node)
    public int get_i(int index)  //Returns int of the
            //i metadata in predicate string line(node)
Created for Misc Methods 
Access: Public
Base Classes: Object
   Members Description   
   public string RemoveCategoryString(string R_TYPE)  
// Returns string without the "K-Lines: " or "Spatial: ",
    // if All then remove string after.
   public string XMLGetNode(string path_xmlfilename, 
   		  		 string elementname)
	// Returns string of data in an element node.
   public string XMLGetAttribute(string path_xmlfilename,
   string elementname, string attributename)
    // Returns string of Attribute data in an element node.
Takes care of Searching ConceptNet text files. 
Access: Public
Base Classes: Object
   Members Description 
    public bool CreateTextFile(string fullfilename)
       // Returns true if Creates a text file using the 
       // current FoundList data.
    public string GetFoundListLine(int index) 
       // Returns string of data in iterator (LineFound[]).
    public int GetTotalLineCount() 
       // Returns int count of total lines found.
    public void SearchFor(string fullpathfilename, 
                          string SubjectWord, 
                          string R_Type, 
                          int MAX_RESULTS, 
                          bool CreateOutputFile, 
                          string fullpathTextFilename)
       //Searches incoming ConceptNet text file 
       //and fills the FoundList iterator (LineFound[]).
       //fullpathfilename = Path of ContextNet .txt
       //fullpathTextFilename = Path of .txt to be created.
	public static string Predicatefile1;
	public static string Predicatefile2;
	public static string Predicatefile3;
	public static string Predicatefile4;
	public static string Predicatefile5;
	public void SearchFor(int index,
	                      string SubjectWord,
	                      string R_Type,
	                      int MAX_RESULTS,
	                      bool CreateOutputFile,
	                      string fullpathTextFilename)
       // Searches incoming ConceptNet int index 1 to x 
       //   and fills the FoundList iterator.				
	 public void XMLSearchForChecked(string path_xmlfilename,
	                                 string SubjectWord,
	                                 string R_Type,
	                                 int MAX_RESULTS,
	                                 bool CreateOutputFile,
	                           string fullpathTextFilename)
      // Searches for the Attribute: (checked="yes") found in 
      //      an XML file and then searches predicate files.
	public static string GetPredicatePathtoFilename(int index)
      // Returns full string path to the requested index number. 
      //   Index starts at 1.
	public void XMLLoadFilePaths(string settingsxmlfile)
      // Sets Predicatefile1 thru  Predicatefile5 variables 
      //       after loading them from an XML file.
    public static int getnode_f(string node)
    public static int getnode_i(string node)
    public void Sort_f(ArrayList inList, out ArrayList rankedList)
    public void Sort_i(ArrayList inList, out ArrayList rankedList)
    public class Compare_f : IComparer
    public class Compare_i : IComparer

How to Run the Demo

1.) Make sure you have downloaded and installed ConceptNet 2.1. (I installed it into path ...\My Documents\Python Projects\conceptnet2.1\)
2.) Download and unzip this article's .Net Solution and project files.
3.) Navigate to the location "...\ConceptNet Demo App\bin\Release" and run the ConceptNet Demo App.exe. It will automaticly open the "Set Location of Knowledgebase Files" dialogbox and, on it's first run, you must click the browse button to a predicate file (ConceptNet or other) then click ok. Following runs will remember the location of checked predicate files you wish to search.
4.) You are now ready to a)Enter a word, b)Choose a relationship (ConceptNet looks at IsA, then PropertyOf), c)Click the Search button to display found nodes. You may then sort them by clicking the "Sort by f" or "Sort by i".

To Do

- Automate the demo's process of locating the concept2.1 files.
- Add combobox to choose which predicate files to search.
- Add MSBNx COM (or some other BN) for creating, assessing, and evaluating Bayesian Networks, and to easily output to XML format.
- Add more methods to the class library.
- Create some more Lifting methods.


ConceptNet 2.1 can be a tool to create personalized commonsense knowledgebase networks. Hopefully this MS VS.Net Class Library project can be informational, useful, and fun.

New Version

The 0.x version posted on this article will no longer be under development. I am working on an updated version using Microsoft Visual C# Express 2005 with .Net 2.0 framework and will serve as the latest version of the ConceptNet Class Library in C# that I am working on. It will probably make use of the IronPython library. If you are interested, here is a small peek into getting ConceptNet Mini-Browser (written in Natural Python code) to execute using IronPython:
My wdevs blog post with some code.
I am just working on it whenever I have free time.


¹ Liu, H. & Singh, P. (2004) ConceptNet: A Practical Commonsense Reasoning Toolkit. BT Technology Journal, To Appear. Volume 22, forthcoming issue. Kluwer Academic Publishers.
ConceptNet: A Practical Commonsense Reasoning Toolkit, Hugo Liu and Push Singh Media Laboratory Massachusetts Institute of Technology
Investigating ConceptNet, Dustin Smith; Advisor: Stan Thomas, Ph.D. December 2004
Open Mind Common Sense Project
Hugo Liu website


  • Added Method in Form1.cs to change the word to lowercase on leaving the textbox. Searches must be performed in lowercase.
  • ConceptNetUtils.Search.SearchFor automatically changes incoming SubjectWord to lowercase.
  • Fixed minor drawing problem with Combobox. (Please email me if you experience this bug.)
  • Added To Do section.
  • Uploaded ConceptNet Demo App version 0.01032006.2rc1 - Uploaded ConceptNetUtils binary version 0.01032006.2b1
  • For the Demo, the loading of the predicate files are now xml stored and automated. They are no longer hardcoded. I added FileOptionsForm.cs to take care of this. I also added an ImageList.
  • For the ConceptNetUtils Class Library, I added XML capability. The demo creates a Settings.xml file to hold the locations of the predicate files and now the class library can read xml files.
  • Search.cs: Added SearchFor() overload, XMLSearchForChecked(), GetPredicatePathtoFilename(), XMLLoadFilePaths().
  • Misc.cs: Added XMLGetNode(), XMLGetAttribute()
  • Uploaded ConceptNet Demo App version 0.01092006.0rc2 - Uploaded ConceptNetUtils binary version 0.01092006.0b2
  • Added some details about ConceptNet's Normalization and Relaxation Processes in the "What is so Unique about ConceptNet?" section.
  • For the Demo, I added two new buttons "Sort by f" and "Sort by i", this demonstrates "The Relaxation Process" of the ConceptNet project.
  • For the ConceptNetUtils Class Library, I added some methods needed to accomplish the "The Relaxation Process" of ConceptNet. I also fixed some problems when it had to search more than one predicate file.
  • Search.cs: Added getnode_f(), getnode_i(), Sort_f(), Sort_i(). Two IComparer Classes were also added to assist with the sorting/Lifting of the knowledge, Compare_f : IComparer, Compare_i : IComparer.
  • FoundList.cs: Added get_f(), get_i().
  • Notified MIT's ConceptNet team of this article via email.
  • Emptied \doc folder with VS generated documentation from project.
  • Uploaded ConceptNet Demo App version 0.01142006.0rc4 - Uploaded ConceptNetUtils binary version 0.01142006.0b3
  • Edited Introduction section.
  • Edited Search.cs XMLSearchForChecked method documentation.
  • Modified ConceptNetUtils.Search.SearchFor() to only return word only results. For example, a search for "eat" was also returning "theater" etc.
  • Uploaded ConceptNet Demo App version 0.01152006.0rc5 (build 2206.41738) - Uploaded ConceptNetUtils binary version 0.01152006.0b4 (build 2206.41736)
  • Edited the "How to Run the Demo" section to reflect the new version of the demo and class library.
  • Edited the link to IronPython-1.0-Beta3 in the "What is Needed and Where to download it..." section (was Beta 1).
  • Added "New Version" section. 0.x is no longer under development and a new ConceptNetUtils class library (that is .Net 2.0 / IronPython  based) is being developed.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Network Administrator
United States United States
Born in Pennsylvania (USA), just north of Philadelphia. Joe has been programming since he was ten[now much older]. He is entirely self-taught programmer, and he is currently working as a Network Administrator (and a bunch of other crap) in Seattle WA. He was previously U.S. Navy Active Reservist for (SPAWAR)
In '98 was honorably discharged from the USN. He served onboard the USS Carl Vinson (94-98) He was lucky enough to drink President Clinton's leftover wine, promoted by his Captain, and flew in a plane off the flightdeck but not all at the same time. His interests, when time allows, are developing
misc apps and Artificial Intelligence proof-of-concept demos that specifically exhibits human behavior. He is a true sports-a-holic, needs plenty of caffeine, and a coding junkie. He also enjoys alternative music and a big Pearl Jam, Nirvana, and new alternative music fan.
Joe is an INTP[^] personality type. Joe "sees everything in terms of how it could be improved, or what it could be turned into. INTP's live primarily inside their own minds." INTPs also can have the "greatest precision in thought and language. Can readily discern contradictions and inconsistencies. The world exists primarily to be understood. 1% of the total population" [
Follow on   Twitter   Google+   LinkedIn

Comments and Discussions

GeneralCan't run ConceptNet Demo App Pinmemberzin_zin7-Sep-06 19:37 
GeneralRe: Can't run ConceptNet Demo App PinmemberJoeSox7-Sep-06 20:58 
GeneralRe: Can't run ConceptNet Demo App Pinmemberzin_zin7-Sep-06 21:16 
GeneralRe: Can't run ConceptNet Demo App PinmemberJoeSox8-Sep-06 4:18 
GeneralRe: Can't run ConceptNet Demo App Pinmemberbillwstarkey14-Jun-07 1:47 
NewsNew Version Available - ConceptNetUtils2.dll PinmemberJoeSox23-Jul-06 20:44 
GeneralUnderstanding Dependancies Pinmembermansidshah23-Jul-06 18:43 
AnswerRe: Understanding Dependancies PinmemberJoeSox23-Jul-06 20:41 
GeneralRe: Understanding Dependancies Pinmembermansidshah26-Jul-06 19:37 
GeneralConceptNet's XML-RPC and .NET Pinmemberkzachos22-Jun-06 3:51 
GeneralRe: ConceptNet's XML-RPC and .NET PinmemberJoeSox22-Jun-06 4:39 
kzachos wrote:
just wondering whether you've tried to use in order to access ConceptNet from .NET platform.

I have not had enough spare time to explore this way of using ConceptNet with .NET. I have ran the ConceptNet server service before but not to any depth.

kzachos wrote:
I am using XML-RPC.NET as the client. I have no problems accessing some of the "easier" methods like chunk(text), but i dont seem to be able to access methods like get_analogous_concepts(textnode, simple_results_p=0).

I have no previous experience using XML-RPC.NET so I may not be of great help, but I do have an understanding of ConceptNet. The first thing that ConceptNet does is create the semantic map of the predicated files. I am not sure, mostly because I can't remember, if the server service does this or not. If it doesn't you need to call methods like load_predicates_file(self,filename) before calling get_analogous_concepts().

kzachos wrote:
I am not sure what the parameter and result type should be in c#.

If I remember correctly for get_analogous_concepts(textnode, simple_results_p=0) textnode is the text value of what is written in the ConceptNet GUI demo mini-browser and simple_results_p is set to 0 if no incoming arg is set.
Remember that Python objects are insanely different that .Net objects. I have come to the conclusion the my next C# library of ConceptNet will certainly be tied into IronPython. You may need to reference IronPython in your XML-RPC.NET.
Anyway, the result type of scored_candidates is an instance of a builtin python list. This is why it will probably be easier if you use IronPython with your project.
Interesting stuff. I'd like to see any of your code in email or in an article when you wish to share. Hope that help you.
Later, JoeSox
"Football is a game of cliches, and I believe in every one of them." -Vincent Lombardi
GeneralRe: ConceptNet's XML-RPC and .NET Pinmemberkzachos22-Jun-06 5:09 
GeneralRe: ConceptNet's XML-RPC and .NET [modified] PinmemberJoeSox22-Jun-06 6:24 
Questionwhat about web service Pinmembershrik'st23-Feb-06 5:15 
AnswerRe: what about web service PinmemberJoeSox23-Feb-06 7:07 
Generalnot quite sure... Pinmemberjconwell10-Jan-06 6:55 
GeneralRe: not quite sure... PinmemberJoeSox10-Jan-06 7:31 
GeneralNeat Pinmembercomputerguru923824-Jan-06 13:50 
GeneralRe: Neat PinmemberJoeSox4-Jan-06 13:58 
QuestionRe: Neat PinmemberMika12-Jan-06 9:01 
AnswerRe: Examples for usage PinmemberJoeSox12-Jan-06 9:23 
GeneralMiscategorized PinmemberRavi Bhavnani4-Jan-06 8:46 
GeneralRe: Miscategorized PinmemberJoeSox4-Jan-06 9:11 
GeneralRe: Miscategorized PinmemberRavi Bhavnani4-Jan-06 9:54 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.150327.1 | Last Updated 22 Feb 2006
Article Copyright 2006 by JoeSox
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid