CFD Online Logo CFD Online URL
www.cfd-online.com
[Sponsors]
Home > Forums > CFD-Wiki

Reference format

Register Blogs Members List Search Today's Posts Mark Forums Read

Reply
 
LinkBack Thread Tools Display Modes
Old   September 14, 2005, 15:45
Default Reference format
  #1
jasond
Guest
 
Posts: n/a
Hello,

Has a reference format been chosen? I think we need to set a uniform reference/citation format, especially before things have grown too much. I just copied from the Baldwin-Lomax article, but I think the format should be something specified somewhere.

Jason
  Reply With Quote

Old   September 14, 2005, 17:00
Default Re: Reference format
  #2
Jonas Larsson
Guest
 
Posts: n/a
We haven't really discussed it. I picked the format for the references in the Baldwin-Lomax article. FYI, you can see it here:

http://www.cfd-online.com/Wiki/index...del#References

In short the format is:

* Order alphabetically after first author

* If you want to number the references use [1] - ( (1) is used for equations)

* Make a bulleted list

* Write author names in bold and as "Firstname1 Lastname1 and Firstname2 Lastname2"

* Write the title in italics and enclose it with ""

* Write the rest of the bibliographic info in normal text like this: Journal, Volume, Number, Pages, Date/Year

What do you think about this?

In any case we should make a template of it so that we can change the format later on. I made one such template. If you click on "edit" on the Baldwin-Lomax page and check the source for the last reference you can see how the template is used.

Another option which I thought a bit about is to make one global reference page for the entire wiki. But I think that this would be a bit difficult to maintain (there is no buildt in support for numbering references etc) and I think I prefer to have the references related to a page/article easily visibile right on that article.

What do you think? Any other suggestions on how to handle and/or format references?
  Reply With Quote

Old   September 14, 2005, 17:08
Default Re: Reference format
  #3
zxaar
Guest
 
Posts: n/a
I have a little problem, that how to give reference when i write something based on user documentations , say Fluent documentation. Because, for me major source of learning is fluent doc and i have added RNG k -epsilon model based on it.
  Reply With Quote

Old   September 14, 2005, 17:28
Default Re: Reference format
  #4
Jonas Larsson
Guest
 
Posts: n/a
Difficult questions. Let me write what I think about it spontanously.

First, the Wiki is not a research paper where it is mandatory to reference all sources and authors who have worked on the same problem. For the RNG k-epsilon model I would say that a reference to the Fluent manual is a bit questionable. The Fluent manual just repeats what has already been published in other papers. I think that the references we put in the Wiki should be references to the original sources and perhaps a few other references to followup papers or books that are good and provide additional information lacking in the original references.

However, it still has some value to inform readers that, as in the RNG k-eps case, the model formulation comes from the Fluent manual. Who knows, Fluent might have their own twist on this model and then people should be informed about where the formulation comes from. Best is of course if you, or someone else improving the article after you wrote it, could check out the original references. However, if you only have access to the Fluent manual then I'd suggest that you write a short note that the formulation was taken from there, but also include the original papers as references (they are most likely referenced in the Fluent manual).

Any other opinions?

About formatting a reference to a manual. For a manual without any author the template would not work very well. So perhaps you should just write it manually in a similar format (Reference Manual, Fluent 6, Volume ??, Chapter ??, Page ??, Year) where "Reference Manual, Fluent 6" is in bold.

  Reply With Quote

Old   September 14, 2005, 17:38
Default Re: Reference format
  #5
zxaar
Guest
 
Posts: n/a
There are some models for which its difficult to find the material, what user manuals do is, they write the model in terse form and most applicable form that is, by reading it user can certianly know how it is solved. Giving a reference to user manual is not bad idea, becuase in anycase we are giving the source of information. i guess it is better,

(Reference Manual, Fluent 6, Volume ??, Chapter ??, Page ??, Year), except for page ,so it could be this,

Reference Manual, FLUNET6.2, "Turbulence Modelling".

  Reply With Quote

Old   September 14, 2005, 23:09
Default Re: Reference format
  #6
Praveen. C
Guest
 
Posts: n/a
I agree. But I have one suggestion. It is customary to put textbook titles in italics and paper titles in quotations. Its a nice way to easily distinguish though it is a minor issue.
  Reply With Quote

Old   September 14, 2005, 23:31
Default Re: Reference format
  #7
zxaar
Guest
 
Posts: n/a
minor issues are important, like i was completely ignorant of this, i will make the changes where i put the references
  Reply With Quote

Old   September 15, 2005, 04:49
Default Re: Reference format
  #8
Jonas Larsson
Guest
 
Posts: n/a
Yea, you're right, so lets agree on that then. I have made two templates with a suggested reference format which you can use according to the following examples:

{{reference-paper|author=Granville, P. S.|year=1987|title=Baldwin-Lomax Factors for Turbulent Boundary Layers in Pressure Gradients|rest=AIAA Journal, Vol. 25, No. 12, pp. 1624-1627}}

{{reference-book|author=Batchelor, G. K.|year=2000|title=An Introduction to Fluid Dynamics|rest=ISBN 0521663962, 1st Edition, Ch. 5.7 Boundary Layers, pp.303}}

Note also that if you include the "ISBN #####" part in the "rest" section then the Wiki automatically hot-links this with pointers to Amazon and a few other online book stores where the book can be purchases - nice.

I have changed the reference in the previous mentioned Baldwin-Lomax article to use these templates, see:

http://www.cfd-online.com/Wiki/index...in-Lomax_model

If you all agreee with this suggestion I'll write a short note about it in the guidelines.
  Reply With Quote

Old   September 15, 2005, 04:50
Default Re: Reference format
  #9
Jonas Larsson
Guest
 
Posts: n/a
I forgot to say that we also perhaps need a 3rd template for referencing manuals (they usually don't have any author).
  Reply With Quote

Old   September 15, 2005, 05:52
Default Re: Reference format
  #10
Praveen. C
Guest
 
Posts: n/a
This is excellent. References can be totally standardized.

Sometimes papers or reports are available online. How would we link to them ? I suppose linking it within the title should work

title=[http://someurl Title of paper]
  Reply With Quote

Old   September 15, 2005, 06:30
Default Re: Reference format
  #11
Jonas Larsson
Guest
 
Posts: n/a
Yea, you can just include the link in the text you supply the template with. We can do this in a couple of different ways, either we make the title of the paper be a link as you suggest or we make a small "download" link at the end. I'm not sure what I prefer. For authors who have home-pages we might also hot-link their names.

I made an example of how it could look in the reference to Hrvoje's thesis here:

http://www.cfd-online.com/Wiki/index...erm#References

This example uses a (download) links instead of hot-linking the title. What do you guys prefer?

The danger with external links like this is that they tend to break with time as people re-arrange their homepages or change employers. So it will be tougher to maintain the Wiki. A different approach would be to instead ask for permission from those authors who have their papers online to also upload them to the wiki and link to them locally instead. That would reduce the risk of external links breaking with time.
  Reply With Quote

Old   September 15, 2005, 06:58
Default Re: Reference format
  #12
Jonas Larsson
Guest
 
Posts: n/a
I've thought a bit more about this and my suggestion is that if the book or paper is available for download as a pdf or so then we make a (download) link and if the book/paper has a home-page of some sort (in html) then hot-link that to the title. It is nice to be able to see that a link does not point to another web-page but to a pdf document or so.

Any objections, or do you agree?
  Reply With Quote

Old   September 15, 2005, 22:55
Default Re: Reference format
  #13
Praveen. C
Guest
 
Posts: n/a
Seems fine to me.
  Reply With Quote

Old   April 12, 2008, 08:42
Default Re: Reference format
  #14
hafizah bte md.malik
Guest
 
Posts: n/a
Just tell me how to write reference and also the format
  Reply With Quote

Reply

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are On


Similar Threads
Thread Thread Starter Forum Replies Last Post
Reference Values- Reference Area Shivakanth FLUENT 9 October 19, 2014 08:42
The format of add new BC ivanyao OpenFOAM Pre-Processing 0 November 13, 2008 22:30
help!!! 3ds format to DXF Pin Main CFD Forum 0 September 3, 2006 20:38
Reference Format Guidelines - a Proposal Jonas Larsson CFD-Wiki 4 September 16, 2005 04:54
Fluent/UNS binary file format reference Federico FLUENT 0 October 11, 2001 04:50


All times are GMT -4. The time now is 01:36.