How to use this organic data science wiki

From Age of Water
Revision as of 18:52, 3 April 2014 by Gil (Talk | contribs)

Jump to: navigation, search

This is a reference guide on how to use this semantic wiki to add structured information.

Adding New Text to Existing Pages

This wiki allows basic editing by adding regular wiki text and content. When editing, and before adding any text, click on the "Save Page" button at the bottom. After that select a category. Then you can either: 1) add structured properties by clicking on the "Add" button, or 2) add text and figures as in any other wiki by clicking on the "Edit" button at the top right. To format text and figures, see the Quick Guide to Using a Wiki, or the detailed User's Guide.

Adding and Editing Pages

Creating a new Page

Just go to http://www.organicdatascience.org/index.php/New_Page

[Replace "New Page" above to the name that you want for the page]

Then, either select a category for this page

Category.png

Or, just click on the "Create" link to create a page without any category

Create.png


Deleting a Page

Go to http://www.organicdatascience.org/index.php/Name_of_Page

[Replace "Name of Page" above to the name of the page to delete]

Then click on the "Delete" link, and delete the page.

Delete.png
Delete2.png

Renaming a Page

Go to http://www.organicdatascience.org/index.php/Name_of_Page

[Replace "Name of Page" above to the name of the page to rename]

Then click on the "Move" link, and set the new name

Rename.png
Rename2.png

Adding Structured Data

All pages in this wiki (except the Main Page) have a "Structured Data" Section.

StructuredData2.png

Asserting Property Values

A user can click on the "Add" button to add a Property and Value pair. Matching properties in the wiki are suggested to the user as he types. In case the user decides to write his own property, this property is then automatically added to the wiki.

StructuredData.png

Deleting Property Values

Click on the [x] link next to the Property Value pair that you want to delete.

Setting Property Type

The type of a property is guessed by the value that the user puts in while asserting a property value. In case, the user wants to set the property type himself, he can go to the property page ( http://www.organicdatascience.org/index.php/Property:Name_of_Property ) and edit the wiki text to change the type.

For example, if one goes to Property:Resolution, he sees the following.

PropertyType1.png

On Editing the wiki text

PropertyType2.png

Directly creating a new property

Create a new page for the property by navigating to http://www.organicdatascience.org/index.php/Property:Name_of_New_Property

Deleting a property

Navigate to the property page ( http://www.organicdatascience.org/index.php/Property:Name_of_Property ), and Delete it. (Refer to Deleting a page above on how)

Note: Deleting the property page will not automatically delete assertions of that property in other pages. That will have to be done manually.

Renaming a property

Navigate to the property page ( http://www.organicdatascience.org/index.php/Property:Name_of_Property ), and Move it. (Refer to Renaming a page above on how)

Note: Renaming the property page will not automatically rename assertions of that property in other pages. That will have to be done manually.


Special UIs for Categories

Task Category

A Task category page allows the user to describe a Task and specify its subtasks and answers.

Task.png

Answer Category

An answer category page allows the user to describe an Answer

Answer.png

Workflow Category

This category page allows a user to import a Workflow Description as stored in OPMW. Example URL: http://www.opmw.org/export/page/resource/WorkflowTemplate/AQUAFLOW_NTM

Workflow.png

After importing:

Workflow2.png


ExecutedWorkflow Category

This category page allows a user to import an Executed Workflow's provenance as stored in OPMW. Example URL: http://www.opmw.org/export/page/resource/WorkflowExecutionAccount/ACCOUNT1383027155436

ExWorkflow.png

After importing:

ExWorkflow2.png


Person Category

A Person category page is associated with a Wiki User ID by the "Has User ID" property. Add this in the Structured Data section.

Person1.png

Once, this is done then the Person Category page will have the following UI to show the user's contributions to the wiki:

Person2.png


Credits for Users

At the bottom of each page (except the main page), credits are shown to show which users have edited that page.

Credits.png


Using Structured Content to Dynamically Create Sections of Wiki Pages

Those properties can then be used to answer queries that aggregate automatically those properties and pages. Below are some examples of how a query can be stated using those structured properties, and the automatically generated table that answers the query. These queries can be used to create dynamically generated content.

 AuthorSoftware licenseLanguage
Delft3dDeltares systems
IPH-ECODavid da Motta Marques
PIHM SoftwareGopal Bhatt
Lorne Leonard
Xuan Yu
Chris Duffy
Mukesh Kumar
GPL v2C
C++


 ExpertiseAffiliation
Chris DuffyHydrologyPennsylvania State University
Craig SnortheimHydrodynamic modelingCenter for Limnology
University of Wisconsin-Madison
David da Motta MarquesHydrology
Hydrodynamic modeling
Universidade Federal do Rio Grande do Sul
Hilary DuganPhysical limnologyUniversity of Wisconsin-Madison
Center for Limnology
Jordan ReadHydrodynamic modeling
Physical limnology
Center for Integrated Data Analytics
U.S. Geological Survey
Matt HipseyEcosystem modeling
Hydrodynamic modeling
University of Western Australia
Michael PaceUniversity of Virginia
Patricia SorannoLandscape limnologyMichigan State University
Paul HansonCarbon cyclingCenter For Limnology
University of Wisconsin - Madison
Steve JepsenUniversity of California Merced
Tom HarmonUniversity of California Merced
Xuan YuPennsylvania State University
Yolanda GilAI planning and collaborative problem solving
Workflows
Semantic Web
Semantic wikis
Social computing
Information Sciences Institute
University of Southern California

Accessing Structured Content Externally

The structured content in this semantic wiki is represented with the W3C RDF semantic representation standard. This allows others to access and import the content of this wiki into their applications. There is extensive documentation about this API here.