Difference between revisions of "Object Recognition with Deep Boltzmann Machines"

Revision as of 15:58, 3 February 2010

This page explains how the creation and modification of project pages is done. See here for the complete lifecycle of a project within the AIRWiki.

Adding a new project to the AIRWiki

1. Become an AIRWiki user. To modify the wiki (including the creation of new pages), you must be one or AIRWiki's registered users. SMW_Project_Workflow#Student_Registration explains what you have to do.
2. Create a page for the project in the AIRWiki. Each project must have an associated page. If the project you are going to work on hasn't already one, you have to create it by following the procedure described in SMW_Project_Workflow#Project_Instantiation. It's a good idea to ask your Tutor for the name of the new page.
3. Provide basic information about your project. The new page you just created already includes an automatically-generated frame on the right upper corner, used to show the basic data about your project. You can input or edit such data by clicking the "edit with form" tab on the top of the page: when you finish, click the 'Save page' button on the bottom of the page.
4. Describe your project by editing the project's page and adding information about it (see below for directions).

Please note that everything in the AIRWiki must be written in English.

As your work on the project progresses, don't forget to keep your project's page up-to-date by editing it every time you have new material.

Editing a project page

READ THIS FIRST!

The AIRWiki is divided into two parts, called Layers: a public layer -readable by anyone on the internet- and a private layer - only readable by Registered users. Registered users can modify both layers of AIRWiki.

If you publish something on the public layer, all the world can see it. And you have full personal responsibility for what you publish (see the General disclaimer, also accessible by clicking the "Disclaimers" link on the bottom of every AIRWiki page). You should not be too worried by the possibility that you publish something that doesn't make sense scientifically or technically: all of us make mistakes. But there are types of mistakes which mean big trouble, such as publishing copyrighted material. See Registered users#Warnings for further information.

OK, I know what I'm doing. How do I do I edit a page?

Editing pages of the AIRWiki requires writing or changing WikiMedia source code (WikiMedia is the system used to build AIRWiki, the same used for Wikipedia). You don't know how WikiMedia code works? Don't worry, it's very easy to learn. Take a look to the MediaWiki Help. [| This] is one of the most useful help pages.

A good starting point is looking around the AIRWiki (or Wikipedia!) and clicking 'edit' here and there to see what the source code of the pages look like (just don't save any modifications!). If you see something useful, you can copy the code and paste it into your page.

There are several ways to edit a page, for instance to add new information:

• to edit the private layer of the page, just click on the "discussion" tab on the top of the page and, in the editing page that opens, change the source code.
• to edit the basic information shown in the frame on top right of a project page, you can choose a simplified method by clicking the "edit with form" tab on the top of the page. Such information belong to the public layer of the page.
• to have full access to the public layer of the page (including the basic information), click the 'edit' tab on the top of the page.

Once you have performed your editing actions, it's a very good idea to check the page before saving. You can do this by clicking the 'Show preview' button and looking at ALL the page (including the parts that you didn't modify... or thought you didn't :-) ). If you don't like what you see, press the 'back' button of your browser to exit from the editing page without saving. If, instead, all is ok, click the 'Save page' button at the bottom of the page to update the AIRWiki.

Important: don't change the Semantic Media Wiki code (the lines between Template:And on top of the wiki code) of any page if you don't know what you are doing!

You are strongly encouraged to use your project's page to store ANY useful information about the project, as soon as it is available. If such information is already sufficiently well-proven and well-formatted to be put on the public layer, you should directly put it there; if it is not, you should put it into the private layer, then prepare it for publication and finally move it to the public layer as soon as possible. See #Public or private? to understand what you should put into the public layer and what you should, instead, put into the private layer.

Tip: if you are editing the private layer of a project "MyProject", on the top of the web page you are looking at there is the title "Editing Talk:MyProject". If the title is "Editing MyProject" (i.e. if Talk: is missing), you are editing the public layer. For additional information, see Layers.

Public or private?

The right thing to do is to treat your project's page as an online repository of everything related to the project. You are encouraged to do just that. By doing so you:

• help anyone that is working or will work on your project or a similar one by recording all useful information;
• can access your documentation through the internet, from any PC.

As soon as you have some new information about your project (results, images, data, links, decisions, roadmaps, what you have done today, descriptions of things gone well or of errors made, warnings, and pretty much everything), it's very important that you put it into the project's page. In this way you will create a trace of how the project is proceeding, what difficulties you had to overcome, and how that was accomplished. To know how to put information in, see #HOWTO add information to a project page.

The obvious problem is: what information must be put into the "public" layer of the project's page and what should instead put into the "private" layer? You should follow these guidelines:

• Any text of the public layer of AIRWiki must be written in English;
• Anything on the public layer of AIRWiki should be sufficiently "finished" and checked for errors. Of course errors occur, so you shouldn't be too worried about that, but remember that you are creating a public page on the internet. If something needs to be revised or checked, leave it in the private layer until it's ready.
• You should, eventually, migrate most of the content of the private layer to the public layer. (Well, excluding the details regarding your work that cannot be of interest to anyone out of the AIRLab, such as how much you paid for this and that :-) ) So:
  • try to keep the contents of the private layer of your project's page well organized: in this way the migration will be easy;
  • it's a good idea if you directly write everything in English!
• Try to include into the project's page everything you would have liked to find there (if you work on a project started by others) and everything you think that people working on it in the future will like to find.
• It is especially useful if you include a project diary into the private part of your project's page: a short description of everything you do, why you did it, and what resulted from it. This will be invaluable for those that will have to take your work further!

A final note: for your teachers, the AIRWiki will be the main source of information about how your project is going, so they will look at its page (public and private parts) often and with attention :-)