Ggarrid: Ggarrid moved page Web-services: Intelligent Assignment to PeerLogic Web Services: Intelligent Assignment

2022-02-22T02:35:39Z

Ggarrid moved page Web-services: Intelligent Assignment to PeerLogic Web Services: Intelligent Assignment

← Older revision	Revision as of 02:35, 22 February 2022
(No difference)

Ggarrid: /* Accessing the service */

2022-02-15T02:35:57Z

Accessing the service

← Older revision		Revision as of 02:35, 15 February 2022
Line 6:		Line 6:
	This service is hosted at: http://peerlogic.csc.ncsu.edu/intelligent_assignment/[method name]. This service can be called without copying the code onto your local machine, simply make a post request to this url with one of the method names mentioned below.		This service is hosted at: http://peerlogic.csc.ncsu.edu/intelligent_assignment/[method name]. This service can be called without copying the code onto your local machine, simply make a post request to this url with one of the method names mentioned below.


	===Run it on your local machine===		===Run it on your local machine===
	The service can be copied from its github repository (https://github.com/peerlogic/IntelligentAssignment). It should be deployed as a webservice; though, it will also require the python libraries flask and scipy:		The service can be copied from its github repository (https://github.com/peerlogic/IntelligentAssignment). It should be deployed as a webservice; though, it will also require the python libraries flask and scipy:

Ggarrid: Created page with "=Intelligent Team and Topic Assignment= Intelligent assignment creates teams based off of each individual users ranking of topic preference, using k-means clustering. This web..."

2022-02-15T02:35:36Z

Created page with "=Intelligent Team and Topic Assignment= Intelligent assignment creates teams based off of each individual users ranking of topic preference, using k-means clustering. This web..."

New page

=Intelligent Team and Topic Assignment=
Intelligent assignment creates teams based off of each individual users ranking of topic preference, using k-means clustering. This webservice requires an input of each users ranks [1 being most preferred, and 0 indicating no preference] and unique id [pid], as well as the max team size. This also uses top trading cycles to switch members of teams who have already worked with other members on that team.

==Accessing the service==
===Access the Webservice online===
This service is hosted at: http://peerlogic.csc.ncsu.edu/intelligent_assignment/[method name]. This service can be called without copying the code onto your local machine, simply make a post request to this url with one of the method names mentioned below.

===Run it on your local machine===
The service can be copied from its github repository (https://github.com/peerlogic/IntelligentAssignment). It should be deployed as a webservice; though, it will also require the python libraries flask and scipy:

-[Scipy](https://www.scipy.org/scipylib/download.html)

-[Flask](https://pypi.python.org/pypi/Flask)

==Methods==
===Creating teams (/merge_teams):===
Uses K-means clustering to group users with similar topic interests. Works to eliminate competition for any single topic and increase the likelihood that each user obtains their most preferred topic.

===Sample input and output===

Input:
<pre>
{“users”:[
{“ranks”:[1,0,2,3], “pid”:1023},
{“ranks”:[1,2,0,3], “pid”:4535},
{“ranks”:[0,2,3,1], “pid”:1363},
{“ranks”:[2,1,0,3], “pid”:9841}],
“max_team_size”:4}
</pre>

Output:

<pre>
{“users”: [
{“ranks”: [1,0,2,3],”pid”: 1023},
{“ranks”: [1,2,0,3],”pid”: 4535},
{“ranks”: [0,2,3,1],”pid”: 1363},
{“ranks”: [2,1,0,3],”pid”: 9841}],
“teams”: [[1363,9841],[1023,4535]]}
</pre>

===Swapping Team Members (/swap_team_members):===
Uses Top Trading Cycles to swap members, that have already worked with members on their team, with other teams’ members. This method only swaps a max of one member per team per run. Begins by first sorting the list of available members by distance from the teams centroid and then by whether or not other members of the team have worked with them. This method requires a history of users that each user has worked with, along with the general information.

===Sample input and output:===

Input:
{“users”:[
{“ranks”:[1,0,2,3], “history”:[4535,9841,9843], “pid”:1023},
{“ranks”:[1,2,0,3], “history”:[1023,9843,8542], “pid”:4535},
{“ranks”:[0,2,3,1], “history”:[3649,9841,9843], “pid”:1363},
{“ranks”:[2,1,0,3], “history”:[1363,1023,3649], “pid”:9841}],
“teams”: [[1023,2549],[4535,9843],[1363,1867,3649],[9841,8542,7521]]}

Output:
{“users”: [
{“ranks”: [1, 0, 2, 3], “pid”: 1023, “history”: [4535, 9841, 9843]},
{“ranks”: [1, 2, 0, 3], “pid”: 4535, “history”: [1023, 9843, 8542]},
{“ranks”: [0, 2, 3, 1], “pid”: 1363, “history”: [3649, 9841, 9843]},
{“ranks”: [2, 1, 0, 3], “pid”: 9841, “history”: [1363, 1023, 3649]}],
“teams”: [[9841, 4535], [1023, 1363]]}

Client Code Example
<pre>
python
import requests
import json

#Test data
data = json.dumps(
{"users":[
{"ranks":[1,0,2,3], "history":[4535,9841,9843], "pid":1023},
{"ranks":[1,2,0,3], "history":[1023,9843,8542], "pid":4535},
{"ranks":[0,2,3,1], "history":[3649,9841,9843], "pid":1363},
{"ranks":[2,1,0,3], "history":[1363,1023,3649], "pid":9841}],
"max_team_size":2}
)

header = {'content-type': 'application/json'}

response = requests.post("http://127.0.0.1:5000/merge_teams",data= data,headers=header)

print response.text

#The response from merge teams can be used in swap team members if
#history was given in the body of the request to merge teams

response = requests.post("http://127.0.0.1:5000/swap_team_members", data=response.text,headers=header)

print response.text
</pre>

PeerLogic Web Services: Intelligent Assignment - Revision history

Ggarrid: Ggarrid moved page Web-services: Intelligent Assignment to PeerLogic Web Services: Intelligent Assignment

Ggarrid: /* Accessing the service */

Ggarrid: Created page with "=Intelligent Team and Topic Assignment= Intelligent assignment creates teams based off of each individual users ranking of topic preference, using k-means clustering. This web..."