Content of PetroWiki is intended for personal use only and to supplement, not replace, engineering judgment. SPE disclaims any and all liability for your use of such content. More information
Sandbox:Data driven analytics
Analytics has been defined as the discovery and communication of meaningful patterns in data. Data-Driven Analytics emphasizes the role of data-centric technologies such as machine learning, data mining, and statistics in performing analysis, and building predictive models. In petroleum engineering context, data-driven analytics relies primarily on data, rather than first preinciple physics, to address drilling, reservoir, production and all other geo-science related problems.
Headings and sections
A page can and should be divided into sections. Sections and subsections are introduced by headings. These headings clarify articles by breaking up text, organizing content, and populating the table of contents. Very short or very long sections and subsections in an article look cluttered and inhibit the flow of the prose. Sections are created by creating headings. Headings are written in sentence case. Heading names of sections (including subsections) should be unique on a page; using the same heading more than once on a page causes problems when linking to heading and/or subheadings. There should be a single blank line between headings.
Possible section headings below are to be used as a guide. These headings are intended to suggest or aid in the development of headings to match specific content need. Development of other headings is encouraged while following the stated guidelines covering heading names.
Standard section headings listed are automatically generated on every PetroWiki page. It is recommended that these headings stay on every page as placeholders for anticipated contributed content even if the initial page author(s) do not add content to the headings listed. These headings should be listed after topic specific headings (Possible Section Headings) placing them near the bottom portion of the topic page.
See also: Headings and sections
Possible section headings
(One or all of these may apply to your topic)
- History: A historic account of the topic
- Purpose or Objective: The reason for its existence, its intended or desired result, or what issue does it resolve.
- Type, taxonomy, or classification: Is there a category or group for this topic?
- Functions: Actions or position this topic occupies in a particular situation or activity.
- Features: What sets this apart or makes this topic important?
- Advantages: What are the positives to this topic?
- Disadvantages: What are the negatives to this topic?
- Other considerations: What other things should the reader think about?
- Nomenclature: Is there a set or system of names or terms used for this topic?
- Gallery: Are there any images that relate to the topic to help illustrate the idea?
- Graphs: Are there any graphs that relate to the topic to help illustrate the idea?
Note: Heading 1 – This heading is a placeholder for the first section of the topic page. On all new pages created, this heading must be revised or deleted.
Standard section headings
(These heading titles are auto generated)
- References: Use this section for citation of items referenced in the text to show your sources. [The sources should be available to the reader, i.e., not an internal company document.]
- Noteworthy papers in OnePetro: Use this section to list papers in OnePetro that a reader who wants to learn more should definitely read.
- Noteworthy books: Use this section to list books that a reader who wants to learn more should definitely read.
- Other noteworthy papers Use this section to list papers not in OnePetro that a reader who wants to learn more should definitely read.
- Online multimedia: Use this section to list multimedia that a reader who wants to learn more should definitely view. [The sources should be available to the reader, i.e., not an internal company document.]
- External links: Use this section to provide links to relevant material on websites other than PetroWiki and OnePetro
- See also: Use this section for links to related pages within PetroWiki, including a link to the original PEH text where appropriate.
Sections usually consist of paragraphs of running prose. Between paragraphs—as between sections—there should be a single blank line, and the first line of each paragraph is not indented. The number of single-sentence paragraphs should be minimized because they can inhibit the flow of the text; by the same token, paragraphs that exceed a certain length become hard to read. Short paragraphs and single sentences generally do not warrant their own subheading; in such circumstances, it may be preferable to use bullet points.
Bullet points should be minimized in the body and lead of the article, if they are used at all; however, a bulleted list may be useful to break up what would otherwise be a large, grey mass of text, particularly if the topic requires significant effort on the part of readers. However, bulleted lists are typical in the reference and reading sections towards the end of the article. Bullet points are usually not separated by blank lines.
See also: Paragraphs
Images and graphs
It is a good idea to try to maintain visual coherence by aligning the sizes of images and graphs on a given page. When placing images, be careful not to stack too many of them within the lead section or within a single section. Images ideally should be spread evenly within the article and be relevant to the sections they are located in. If an article has many images—so many, in fact, that they lengthen the page beyond the length of the text itself—you can use a gallery. All images should also have an explicative caption. An image that would otherwise overwhelm the available text space on an 800×600 window should be shrunk or formatted as a panorama. As a general rule, images should not be set to a fixed size larger than the 220px default. Avoid referring to images as being on the left or right. Image placement is different for viewers of the mobile version of PetroWiki, and it is meaningless to people who use assistive software, such as text to voice programs, to read pages . Instead, use captions to identify images.
A key part with all PetroWiki articles is the interlinking with other relevant articles. Normally, the first occurrence of a word is the one chosen for a link. Do not link to the same article more than once in a section. Avoid creating adjacent links to separate articles because the reader cannot tell whether the link is to one or two articles without pointing to the link.