Changes between Initial Version and Version 1 of JobKeywords

Timestamp:

Jul 31, 2017, 2:31:14 PM (7 years ago)

Author:

davea

Comment:

--

JobKeywords

@@ +1 @@
+= Job keywords =
+
+[DesignKeywords Keywords] describe the attributes of jobs, such as:
+ * The area of science it contributes to
+ * The location of the research group that submitted it.
+
+Keywords are used for various purposes in BOINC, such as
+ * Informational: volunteers can see job keywords in the BOINC Manager
+   and on the project web site.
+ * Preferences: volunteers can express preferences for keywords,
+   which limits what jobs are sent to the volunteer.
+   Currently this is supported in the account manager architecture;
+   it would also be possible to support it at the project level.
+
+== Keyword headers ==
+
+Keywords are identified by permanent integer IDs, and also by symbols mapped to these IDs.
+The current list of keywords can be obtained as:
+
+ * [https://boinc.berkeley.edu/keywords.php an XML file]
+ * [https://boinc.berkeley.edu/keywords.php?header=python a Python header file]
+ * [https://boinc.berkeley.edu/keywords.php?header=c a C header file]
+ * [https://boinc.berkeley.edu/keywords.php?header=bash a Bash header file ]
+ * [https://boinc.berkeley.edu/keywords.php?header=php a PHP header file ]
+
+== Keywords in job submission ==
+
+The [JobSubmission job submission interfaces] let you associate keywords with jobs.
+
+== Keyword scheduling ==
+
+If you include
+{{{
+<keyword_sched/>
+}}}
+in your project's config.xml, score-based scheduling will include a keyword component:
+if a volunteer has a "no" preference for keyword X,
+they won't be sent jobs with keyword X,
+and if they have a "yes" preference,
+they will preferentially be sent jobs with that keyword.
+
+== Project keywords ==
+
+You can also associate keywords with your project as a whole.
+Do this by creating a file "project_keywords.xml" in the project root directory.
+This file has the format
+{{{
+<project_keywords>
+   <keyword>
+      <id>4</id>
+      { <work_fraction>.7</work_fraction> }
+   </keyword>
+   ...
+</project_keywords>
+}}}
+
+Include <work_fraction> if not all jobs have that keyword.
+The number express what fraction of your project's work (measured in FLOPs)
+have that keyword.