valencer

วาเลนเซอร์

ยินดีต้อนรับสู่ Valencer ซึ่งเป็น RESTful API เพื่อค้นหาการรวมกันของการรับรู้ทางวากยสัมพันธ์ของอาร์กิวเมนต์ของเพรดิเคต หรือที่ รู้จักในชื่อรูปแบบวาเลนซ์ ในฐานข้อมูล FrameNet

คุณใช้เราในการทำงานของคุณหรือไม่? กรุณาอ้างอิงเรา!

@InProceedings{kabbach-ribeyre:2016:COLINGDEMO,
  author    = {Kabbach, Alexandre  and  Ribeyre, Corentin},
  title     = {{Valencer: an API to Query Valence Patterns in FrameNet}},
  booktitle = {{Proceedings of COLING 2016, the 26th International Conference on Computational Linguistics: System Demonstrations}},
  month     = dec,
  year      = {2016},
  address   = {Osaka, Japan},
  publisher = {The COLING 2016 Organizing Committee},
  pages     = {156--160},
  url       = {http://aclweb.org/anthology/C16-2033}
}

เอกสารประกอบ

เอกสารฉบับสมบูรณ์ของ API มีอยู่ในหน้า GitHub ของเรา

พื้นหลัง

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับความเป็นมาของ API สถาปัตยกรรม และกรณีการใช้งาน โปรดดูเอกสาร COLING 2016 ของเรา

ความต้องการ

• มอนโก >= v3.4
• โหนด >= v7.6

หากต้องการนำเข้าข้อมูล FrameNet ไปยังฐานข้อมูล Mongo ให้ตรวจสอบ NoFrameNet

หรือเราจะจัดเตรียม MongoDB dump สองรายการสำหรับข้อมูล FrameNet 1.5 และ FrameNet 1.7 หากคุณใช้งาน MongoDB บน ​​localhost และพอร์ต 27017 คุณสามารถนำเข้าไฟล์ดัมพ์ได้อย่างง่ายดายเมื่อคลายซิปผ่าน:

 mongorestore -d fn_en_170 /path/to/fn_en_170/

ข้อมูลเพิ่มเติมสามารถดูได้จากเอกสาร MongoDB

หากคุณกำลังใช้ดัมพ์ของเรา โปรดอย่าลืมยื่นใน FrameNet Data Request

วิธีการ – เริ่มเซิร์ฟเวอร์ Valencer

ติดตั้งการพึ่งพาที่จำเป็น

รันคำสั่งต่อไปนี้ในเทอร์มินัลของคุณ ใต้ไดเร็กทอรี Valencer:

 npm install

ตั้งค่าคอนฟิก

แก้ไขไฟล์ config/production.js ตามการตั้งค่าที่คุณต้องการ:

 const config = {
  logger: logger.info,
  api: {
    port: 3030,
  },
  databases: {
    server: 'localhost',
    port: 27017,
    names: {
      en: {
        150: 'fn_en_150',
        160: 'fn_en_160',
        170: 'fn_en_170',
      },
      ja: {
        100: 'fn_ja_100',
      },
    },
  },
};

เริ่มเซิร์ฟเวอร์

หากต้องการเริ่มต้นอินสแตนซ์เดียวของ Valencer ให้รันคำสั่งต่อไปนี้ในเทอร์มินัลของคุณ ใต้ไดเร็กทอรี Valencer:

 npm run start

เพื่อประสิทธิภาพที่ดีขึ้น คุณยังสามารถเริ่ม Valencer ได้หลายอินสแตนซ์ หากต้องการทำเช่นนั้น ให้ส่งต่ออาร์กิวเมนต์ -i ไปที่ npm:

 npm run start -- -i num_instances

หากต้องการสร้างจำนวนอินสแตนซ์สูงสุดโดยขึ้นอยู่กับเธรดที่มีอยู่ ให้ทำดังนี้

 npm run start -- -i 0

หยุดเซิร์ฟเวอร์

หากต้องการหยุดเซิร์ฟเวอร์ ให้รัน:

 npm run stop

โปรดทราบว่ามันจะหยุดอินสแตนซ์ทั้งหมดของ Valencer

การตรวจสอบ

หากต้องการตรวจสอบ Valencer API เมื่อเริ่มต้นแล้ว ให้รัน:

 pm2 monit valencer

หากไม่ได้ติดตั้ง pm2 แบบโกลบอลในสภาพแวดล้อมของคุณ คุณยังสามารถทำ:

 ./node_modules/.bin/pm2 monit valencer

หากต้องการเข้าถึงบันทึกของ Valencer ให้รัน:

 pm2 logs valencer

HowTo – ถามคำถามแรกของคุณ

นี่คือตัวอย่างคำขอ HTTP ที่สอบถาม 10 AnnotationSets แรกในฐานข้อมูลที่อ้างอิงถึงรูปแบบความจุ Donor.NP.Ext Theme.NP.Obj :

 curl -i "http://localhost:3030/v5/en/170/annoSets?vp=Donor.NP.Ext+Theme.NP.Obj"

แบบสอบถามข้างต้นควรส่งออก:

 HTTP/1.1 200 OK
Vary: Origin, Accept-Encoding
Total-Count: 190
Skip: 0
Limit: 10
Content-Type: application/json; charset=utf-8
Content-Length: 4069
Date: Wed, 24 Jan 2018 09:27:14 GMT
Connection: keep-alive

[{"labels":["5a62f8d9e3bf318cbac8aef0","5a62f8d9e3bf318cbac8aef1","5a62f8d9e3bf318cbac8aef2","5a62f8d9e3bf318cbac8aef3","5a62f8d9e3bf318cbac8aef4","5a62f8d9e3bf318cbac8aef5","5a62f8d9e3bf318cbac8aef6","5a62f8d9e3bf318cbac8aef7","5a62f8d9e3bf318cbac8aef8","5a62f8d9e3bf318cbac8aef9","5a62f8d9e3bf318cbac8aefa"],"_id":2614616,"lexUnit":11593,"sentence":1569707,"pattern":"5a62f8d9e3bf318cbac8aefc"},{"labels":["5a62fb28e3bf318cba2ca68f","5a62fb28e3bf318cba2ca690","5a62fb28e3bf318cba2ca691","5a62fb28e3bf318cba2ca692","5a62fb28e3bf318cba2ca693","5a62fb28e3bf318cba2ca694","5a62fb28e3bf318cba2ca695","5a62fb28e3bf318cba2ca696","5a62fb28e3bf318cba2ca697","5a62fb28e3bf318cba2ca698"],"_id":6525725,"lexUnit":11593,"sentence":4096745,"pattern":"5a62f8d9e3bf318cbac8aefc"},{"labels":["5a62fb22e3bf318cba2b987f","5a62fb22e3bf318cba2b9880","5a62fb22e3bf318cba2b9881","5a62fb22e3bf318cba2b9882","5a62fb22e3bf318cba2b9883","5a62fb22e3bf318cba2b9884","5a62fb22e3bf318cba2b9885","5a62fb22e3bf318cba2b9886","5a62fb22e3bf318cba2b9887","5a62fb22e3bf318cba2b9888"],"_id":6527126,"lexUnit":11593,"sentence":4097344,"pattern":"5a62f8d9e3bf318cbac8aefc"},{"labels":["5a62fb25e3bf318cba2c3666","5a62fb25e3bf318cba2c3667","5a62fb25e3bf318cba2c3668","5a62fb25e3bf318cba2c3669","5a62fb25e3bf318cba2c366a","5a62fb25e3bf318cba2c366b","5a62fb25e3bf318cba2c366c","5a62fb25e3bf318cba2c366d","5a62fb25e3bf318cba2c366e","5a62fb25e3bf318cba2c366f"],"_id":6540825,"lexUnit":11593,"sentence":4100815,"pattern":"5a62f8d9e3bf318cbac8aefc"},{"labels":["5a62fb02e3bf318cba27b2ed","5a62fb02e3bf318cba27b2ee","5a62fb02e3bf318cba27b2ef","5a62fb02e3bf318cba27b2f0","5a62fb02e3bf318cba27b2f1","5a62fb02e3bf318cba27b2f2","5a62fb02e3bf318cba27b2f3","5a62fb02e3bf318cba27b2f4","5a62fb02e3bf318cba27b2f5","5a62fb02e3bf318cba27b2f6","5a62fb02e3bf318cba27b2f7"],"_id":6542617,"lexUnit":11593,"sentence":4101222,"pattern":"5a62f8d9e3bf318cbac8aefc"},{"labels":["5a62f8d9e3bf318cbac8aff1","5a62f8d9e3bf318cbac8aff2","5a62f8d9e3bf318cbac8aff3","5a62f8d9e3bf318cbac8aff4","5a62f8d9e3bf318cbac8aff5","5a62f8d9e3bf318cbac8aff6","5a62f8d9e3bf318cbac8aff7","5a62f8d9e3bf318cbac8aff8","5a62f8d9e3bf318cbac8aff9","5a62f8d9e3bf318cbac8affa","5a62f8d9e3bf318cbac8affb","5a62f8d9e3bf318cbac8affc","5a62f8d9e3bf318cbac8affd","5a62f8d9e3bf318cbac8affe"],"_id":2615829,"lexUnit":11593,"sentence":1569663,"pattern":"5a62f8d9e3bf318cbac8b000"},{"labels":["5a62f8d9e3bf318cbac8b019","5a62f8d9e3bf318cbac8b01a","5a62f8d9e3bf318cbac8b01b","5a62f8d9e3bf318cbac8b01c","5a62f8d9e3bf318cbac8b01d","5a62f8d9e3bf318cbac8b01e","5a62f8d9e3bf318cbac8b01f","5a62f8d9e3bf318cbac8b020","5a62f8d9e3bf318cbac8b021"],"_id":2615833,"lexUnit":11593,"sentence":1569671,"pattern":"5a62f8d9e3bf318cbac8b022"},{"labels":["5a62fb2ae3bf318cba2cfde5","5a62fb2ae3bf318cba2cfde6","5a62fb2ae3bf318cba2cfde7","5a62fb2ae3bf318cba2cfde8","5a62fb2ae3bf318cba2cfde9","5a62fb2ae3bf318cba2cfdea","5a62fb2ae3bf318cba2cfdeb","5a62fb2ae3bf318cba2cfdec","5a62fb2ae3bf318cba2cfded","5a62fb2ae3bf318cba2cfdee","5a62fb2ae3bf318cba2cfdef","5a62fb2ae3bf318cba2cfdf0","5a62fb2ae3bf318cba2cfdf1"],"_id":6522246,"lexUnit":11593,"sentence":4096543,"pattern":"5a62f8d9e3bf318cbac8b0ff"},{"labels":["5a62fb25e3bf318cba2c3bf3","5a62fb25e3bf318cba2c3bf4","5a62fb25e3bf318cba2c3bf5","5a62fb25e3bf318cba2c3bf6","5a62fb25e3bf318cba2c3bf7","5a62fb25e3bf318cba2c3bf8","5a62fb25e3bf318cba2c3bf9","5a62fb25e3bf318cba2c3bfa","5a62fb25e3bf318cba2c3bfb","5a62fb25e3bf318cba2c3bfc","5a62fb25e3bf318cba2c3bfd","5a62fb25e3bf318cba2c3bfe","5a62fb25e3bf318cba2c3bff"],"_id":6540732,"lexUnit":11593,"sentence":4100829,"pattern":"5a62f8d9e3bf318cbac8b0ff"},{"labels":["5a62f8e9e3bf318cbaccc46f","5a62f8e9e3bf318cbaccc470","5a62f8e9e3bf318cbaccc471","5a62f8e9e3bf318cbaccc472","5a62f8e9e3bf318cbaccc473","5a62f8e9e3bf318cbaccc474","5a62f8e9e3bf318cbaccc475","5a62f8e9e3bf318cbaccc476","5a62f8e9e3bf318cbaccc477","5a62f8e9e3bf318cbaccc478","5a62f8e9e3bf318cbaccc479","5a62f8e9e3bf318cbaccc47a","5a62f8e9e3bf318cbaccc47b"],"_id":2447117,"lexUnit":12046,"sentence":1500476,"pattern":"5a62f8e9e3bf318cbaccc480"}]