A major part of the website autodiff.org is its BibTeX database. A two-page summary of handling autodiff's BibTeX database is given in the following conference contribution. It contains more detailed information than this web page and is available here in pdf format.

• How do I submit a publication to the database?
• What is BibTeX?
• What are the AD-specific BibTeX fields ad_area, ad_theotech, and ad_tools?
• Can I update the information in the database?
• How do I refer to a publication in the database?

How do I submit a publication to the database?

Suppose that there is some interesting publication on automatic differentiation that you want to share with the community via our database. Here is a step-by-step description how to submit the BibTeX entry of that publication to our publication database:

• Visit the web page "Add Publications".
• Enter the BibTeX entry of the publication manually or copy it from your .bib file and paste it there.
• Click on the button "Submit".

Notes:

• You can submit multiple entries at once by simply appending them.
• If you'd like to submit a larger number of BibTeX entries from a .bib file, send this file to webmaster@autodiff.org and we'll do the rest for you.
• If your BibTeX entries contain crosslinks to other BibTeX entries we recommend to submit them together; otherwise these crosslinks will not be updated and will point to nonexistent BibTeX keys.

[top]

What is BibTeX?

The AD publication database handles entries in BibTeX Format. BibTeX is a very popular bibliographic format and part of the LaTeX document preparation system.

A BibTeX entry usually has the following form:

@BOOK{Corliss2001ADF,

       editor = "George Corliss and Christ{\`e}le Faure and Andreas Griewank and Laurent

         Hasco{\"e}t and Uwe Naumann",

       title = "Automatic Differentiation: From Simulation to Optimization",

       series = "Computer and Information Science",

       publisher = "Springer",

       address = "New York, NY",

       comment = "Conference proceedings, Nice, 2000",

       ad_theotech = "General",

       year = "2001"

}

Fields:
To appear in our database, a BibTeX entry must contain at least the following three fields: title, the year, and either author or editor. All other BibTeX fields are read by the parser, but are optional.
The following fields are queried on a search request: author, editor, title, booktitle, journal, note, abstract, ad_tools, ad_area, ad_theotech. (The last three BibTeX fields are explained in the section ad_tools, ad_area and ad_theotech.)

For information on BibTeX visit BibTeX.org, for information on LaTeX see The LaTeX Project.

Our BibTeX parser currently translates:

• special charakters like {\"a} or {\'C} to ä and Ç
• lots of other LaTeX specific escape sequences (like \- and \%)
• text formating commands like \it{text} for italic or \bf{text} for bold.
• the \cite{ ... } command to add a link to another publication.
• \url{ ... } will be transformed into a link (actually all urls will be transformed into links)
• mathematical formulas will not really be translated, but at least be made a bit more "readable".
• and many more

However, our BibTeX parser does not fully support the BibTeX file format. We apologize for any inconvenience caused by errors in our BibTeX parser. [top]

What are the AD-specific BibTeX fields ad_area, ad_theotech, and ad_tools?

Ultimately, we would like to broadly classify all entries in our publication database according to content. Therefore, we introduced the following three AD-specific BibTeX fields:

• ad_area: information on the application area where AD is used.
• ad_theotech: information on AD theory and AD techniques.
• ad_tools: information on the AD tools that are used.

The purpose of the classification is to associate each BibTeX entry with one or more of the previous three AD-specific fields. This will enable us to provide a search engine capable of looking for referencees on, for instance, a specific AD tool. The value of each of the three fields consists of a string providing further information.
Examples include:

• ad_area = "chemistry"

• ad_theotech = "checkpointing"

• ad_tools = "Tapenade, Adifor"

[top]

Can I update the information in the database?

Yes, you can as a registered user, to a certain degree. Since a new BibTeX entry overwrites an older one with the same key, it is possible to resubmit a BibTeX entry. Just keep in mind that after submission of a new entry the key will be generated again. So, don't change anything that would effect the key, or multiple entries will be generated for the same publication.
[top]

How do I refer to a publication in the database?

When submitting a tool or an application to our database, you will be asked to enter a reference to a publication.
In this case you have several possibilities:

• If the required publication(s) are already in the database (try the advanced search to check this out), you can directly link to them by listing their keys in the following syntax:
  [key1], [key2] ...
  where key1 stands for the corresponding BibTeX key of that publication in our database (see How are the keys generated)
  On the resulting page a short description of the publication(s) with a link to a more detailed one will be displayed.
  
  
• If you cannot find the publications in the database, you have the possibility to copy-and-paste one (or more) BibTeX entries from your own .bib-file into the input field, or if you are a BibTeX guru, type them in manually (see the BibTeX format for more details)
  When you submit the tool or application, the parser will try to translate everything it gets in the reference field. If it succeeds it will write the BibTeX entries to the database and put the corresponding links on the resulting page.
  
  
• If the parser cannot parse your input (i.e. you entered something different than a BibTeX entry, say a normal string), whatever you entered will be displayed on the resulting page. This way you can refer to a publication that you dont want to publish in the database.
  
  

If you want to use the BibTeX entries in this database for your own publications, please feel encouraged to copy-and-paste the BibTeX strings from the detail views of the single publications to your own .bib-file - they were put there for exactly this purpose
We also plan to implement a service that sends an email containing the results of a search in our database as a BibTeX file (using the format .bib).
[top]