Skip to content

Commit

Permalink
fix formatting to allow build
Browse files Browse the repository at this point in the history
  • Loading branch information
harivyasi committed Oct 24, 2023
1 parent 0adb98d commit 39a0db2
Showing 1 changed file with 69 additions and 32 deletions.
101 changes: 69 additions & 32 deletions docs/repo/details_standards/characterization.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,63 +5,100 @@ sidebar_position: 1
---

**How to find and apply information for required standards in chemotion repository**<br />
The page <i> General Topics</i> describes the overall idea of how to deal with data in chemotion repository. This page does not contain details on how to deal with analytical data or how to describe certain types of data. This detailed information can be found at the page [For Analyses](analysis_test) and subpages belonging to it. Information on the data files and types that are supported or need to be provided is part of the section [For Data Files](files).
The page <i> General Topics</i> describes the overall idea of how to deal with data in chemotion repository. This page does not contain details on how to deal with analytical data or how to describe certain types of data. This detailed information can be found at the page [For Analyses](analysis_test) and subpages belonging to it. Information on the data files and types that are supported or need to be provided is part of the section [For Data Files](files).

## Scope
## Scope

**What kind of data should be or can be provided**<br />
The Chemotion repository was established to store comprehensive information wherever available. If chemical reactions were done, please provide the information on the reaction and the target compounds (including their characterization). If the process description is not available or not relevant (e.g. for commercial compounds) "Sample Only" data should be submitted. In general, the repository should be used to provide information on scientific processes and their outcome with the full description of both.
The Chemotion repository was established to store comprehensive information wherever available. If chemical reactions were done, please provide the information on the reaction and the target compounds (including their characterization). If the process description is not available or not relevant (e.g. for commercial compounds) "Sample Only" data should be submitted. In general, the repository should be used to provide information on scientific processes and their outcome with the full description of both.

**Description of processes such as chemical reactions**<br />
Chemical reactions and all other processes need to be described in a way that others with a basic domain knowledge can repeat the work. This means that each step of the work needs to be described sufficiently with all relevat details avoiding unusual or ambiguous abbreviations. All precisely measurable reaction parameters (e.g. weigths, temperatures, durations etc.) need to be given in explicit numbers/values.
Chemical reactions and all other processes need to be described in a way that others with a basic domain knowledge can repeat the work. This means that each step of the work needs to be described sufficiently with all relevat details avoiding unusual or ambiguous abbreviations. All precisely measurable reaction parameters (e.g. weigths, temperatures, durations etc.) need to be given in explicit numbers/values.

**Characterization of compounds**<br />

<b>New compounds:</b> New compounds (not literature known compounds) must be provided with analytical data that adequately approve the identity and degree of purity (homogeneity) of the compound. <br />
<b>Known compounds</b> that exist in the Chemotion repository: At least one evidence for the identity and purity of the compound must be provided. A combination of <sup>1</sup>H or <sup>13</sup>C NMR and mass spectrometry data is desired.<br />
<b>Known compounds</b> that do not exist in the Chemotion repository: please provide analytical data that adequately approves the identity and degree of purity (homogeneity) of the compound. <br />
Details describing the required data are given in the section [For Analyses](analysis_test).<br /><br />
<b>New compounds:</b> New compounds (not literature known compounds) must be provided
with analytical data that adequately approve the identity and degree of purity (homogeneity)
of the compound. <br />
<b>Known compounds</b> that exist in the Chemotion repository: At least one evidence
for the identity and purity of the compound must be provided. A combination of <sup>
1
</sup>
H or <sup>13</sup>C NMR and mass spectrometry data is desired.
<br />
<b>Known compounds</b> that do not exist in the Chemotion repository: please provide
analytical data that adequately approves the identity and degree of purity (homogeneity)
of the compound. <br />
<br />

Details describing the required data are given in the section [For Analyses](analysis_test).

:::info Hint
Please provide at least all data that is usually given in a Supplemental Information for publications. For compounds that are literature known but not described in the Chemotion repository, please add all data that you have - to provide a complete dataset for the community.
Please provide at least all data that is usually given in a Supplemental Information for publications. For compounds that are literature known but not described in the Chemotion repository, please add all data that you have - to provide a complete dataset for the community.
:::

**Missing data**
If a required type of data is not obtainable, the reason for the absence of the data should be noted. For example, if the compound is little soluble and recording a <sup>13</sup>C NMR spectrum is not possible or if the compound can be hardly ionized and mass spectra cannot be gained, please add a note to "Additional information for publication and purification details". For cases where the data was gained but does not meet the requirements, please see the information in the section [For Analyses](analysis_test). <br />

## Numbers and units

### General formating

- Please use numerals with units of time or measures. Use spaces between numbers and units according to common standards: All combinations of number and unit should be given with spaces (e.g. 12 h, 12 min, 12 °C, 12 mM). <br />
<b>Exceptions:</b> number+% (e.g. yield or concentration), and $, ° (angular degrees), ′ (angular minutes), and ″ (angular seconds). <br />
<div style="text-indent:10px;">10px einzug</div> <b>Examples:</b> "The product was obtained in 12% yield or 5% methanol in water." Others: $250, 47°8′23″, 180° (but 180 °C) <br />
- data should be quoted with decimal points and negative exponents (e.g. 25.8 J K<sup>−1</sup> mol<sup>−1</sup>).
<b>Exceptions:</b> number+% (e.g. yield or concentration), and $, ° (angular degrees),
′ (angular minutes), and ″ (angular seconds). <br />
<b>Examples:</b> "The product was obtained in 12% yield or 5% methanol in water."
Others: $250, 47°8′23″, 180° (but 180 °C) <br />
- Data should be quoted with decimal points and negative exponents (e.g. 25.8 J K<sup>−1</sup> mol<sup>−1</sup>).
- Use the period as the decimal point, never a comma. Use numerals before and after a decimal point (e.g. 0.25 not .25 and 78.0 or 78 not 78.)
- For ranges in scientific notation, retain all parts of all numbers or avoid ambiguity by use of parentheses or other enclosing marks. 9.2 × 10<sup>–3</sup> to 12.6 × 10<sup>–3</sup> or (9.2–12.6) × 10<sup>–3</sup> (not 9.2 to 12.6 × 10<sup>–3</<sup>).
- Leave a space before and after mathematical operators that function as verbs or conjunctions, that is, they have numbers on both sides or a symbol for a variable on one side and a number on the other.
<b>Examples:</b> 20 ± 2%; 3.24 ± 0.01; 4 × 5 cm; 8 × 10<sup>–4</sup>; k 420 s<sup>–1</sup>; p < 0.01; T = 176 °C. <br />
Exception: Leave no space around a slash (a/b), a ratio colon (1:10), or a centered dot (PM·V).
- Use the en dash to express “to” in ranges: 12–20 mins, 10–13 mL.
<b>Exception 1:</b> Please use “to” (not the en dash) if one or both numbers are negative or include another symbol: –10 to +10 °C; –10 to –20 °C; ≈ 100 to 110; 100 to > 110 mL; < 1 to 1.5 mg. <br />
<b>Exception 2:</b> Please do not use an en dash in combination with “from” or “between”: from 10 to 20 mL (not: from 10–20 mL), between 1 and 2 hours (not: between 1–2 hours). <br />
- For very large numbers with units of measure, use scientific notation or choose an appropriate multiplying prefix for the unit to avoid numbers of more than four digits. 1.2 × 106 s; 3.0 × 104 kg; 5.8 × 10<sup>–5</sup> M; or 58 µM; 42.3 L (not 42,300 mL or 42 300 mL)
<b>Exception 1:</b> In tables, use the same unit and multiplying prefix for all entries in a column, even if some entries therefore require four or more digits. <br />
<b>Exception 2:</b> Use the preferred unit of a discipline, even when the numbers require four or more digits: g/L for mass density of fluids kg/m<sup>3</<sup> for mass density of solids GPa for modulus of elasticity kPa for fluid pressure MPa for stress. <br />
- For ranges in scientific notation, retain all parts of all numbers or avoid ambiguity by use of parentheses or other enclosing marks. 9.2 × 10<sup>–3</sup> to 12.6 × 10<sup>–3</sup> or (9.2–12.6) × 10<sup>–3</sup> (not 9.2 to 12.6 × 10<sup>–3</sup>).
- Leave a space before and after mathematical operators that function as verbs or conjunctions, that is, they have numbers on both sides or a symbol for a variable on one side and a number on the other.<br />
<b>Examples:</b> 20 ± 2%; 3.24 ± 0.01; 4 × 5 cm; 8 × 10<sup>–4</sup>; k ≥ 420 s
<sup>–1</sup>; p &lt 0.01; T = 176 °C. <br />
<b>Exception:</b>: Leave no space around a slash (a/b), a ratio colon (1:10),
or a centered dot (PM·V).
- Use the en dash to express 'to' in ranges: 12–20 mins, 10–13 mL.<br />
<b>Exception 1:</b> Please use 'to' (not the en dash) if one or both numbers are
negative or include another symbol: –10 to +10 °C; –10 to –20 °C; ≈ 100 to 110;
100 to &gt 110 mL; &lt 1 to 1.5 mg. <br />
<b>Exception 2:</b> Please do not use an en dash in combination with 'from' or
'between': from 10 to 20 mL (not: from 10–20 mL), between 1 and 2 hours (not: between
1–2 hours). <br />
- For very large numbers with units of measure, use scientific notation or choose an appropriate multiplying prefix for the unit to avoid numbers of more than four digits. 1.2 × 106 s; 3.0 × 104 kg; 5.8 × 10<sup>–5</sup> M; or 58 µM; 42.3 L (not 42,300 mL or 42 300 mL).<br />
<b>Exception 1:</b> In tables, use the same unit and multiplying prefix for all
entries in a column, even if some entries therefore require four or more digits. <br />
<b>Exception 2:</b> Use the preferred unit of a discipline, even when the numbers
require four or more digits: g/L for mass density of fluids kg/m<sup>
3
</sup> for mass density of solids GPa for modulus of elasticity kPa for fluid
pressure MPa for stress. <br />
- Omit digit grouping by any delimiters such as ".", "," or thin spaces.
- Use a decimal and a zero following a numeral only when such usage truly represents the precision of the measurement: 27.0 °C and 27 °C are not interchangeable.
- Use decimals rather than fractions with units of time or measure, except when doing so would imply an unwarranted accuracy. 3.5 h (not 3½ h) 5.25 g (not 5¼ g)

### Chemistry-specific general formating
- Use italic type for chemical element symbols that denote attachment to an atom or a site of ligation. <i>B</i>,<i>B</i>′-di-3-pinanyldiborane, bis[(ethylthio)acetato-<i>O</i>,<i>S</i>]platinum, <i>N</i>-acetyl, <i>N</i>-ethylaniline
- When element symbols are used with a type of reaction as a noun or adjective, use normal type for the symbol and hyphenate it to the word that follows it. N-acetylated, N-acetylation, N-oxidation, N-oxidized, O-substituted, O-substitution.

- Use italic type for chemical element symbols that denote attachment to an atom or a site of ligation e.g. <i>B</i>,<i>B</i>′-di-3-pinanyldiborane, bis[(ethylthio)acetato-<i>O</i>,<i>S</i>]platinum, <i>N</i>-acetyl, <i>N</i>-ethylaniline
- When element symbols are used with a type of reaction as a noun or adjective, use normal type for the symbol and hyphenate it to the word that follows it.e.g. N-acetylated, N-acetylation, N-oxidation, N-oxidized, O-substituted, O-substitution.
- Use italic type for the capital H that denotes indicated or added hydrogen. 1<i>H</i>-1,3-diazepine, 3<i>H</i>-fluorene, 2<i>H</i>-indene
- Use Greek letters, not the spelled-out forms, in chemical names to denote position or stereochemistry. Use a hyphen to separate them from the chemical name. <br />
<b> Example: </b>: α-amino acid (not alpha amino acid); β-naphthol (not beta naphthol); 5α,10β,15α,20α-tetraphenylporphyrin; 17β-Hydroxyandrost-4-en-3-on.
- Use italic type for positional, stereochemical, configurational, and descriptive structural prefixes when they appear with the chemical name or formula. Use a hyphen to separate them from the chemical name. Examples: <i> abeo, ac, altro, amphi, anti, antiprismo, ar, arachno, as, asym, c, catena, cis, cisoid, closo, cyclo, d, dodecahedro, E, endo, erythro, exo, facgem, hexahedro, hexaprismo, hypho, icosahedro, klado, l, m, M, mer, meso, n, nido, o, octahedro, p, P, pentaprismo, quadro, r, R, R∗, rel, retro, ribo, s, S, S∗, sec, sn, sym, syn, t, tert, tetrahedro, threo, trans, transoid, triangulo, triprismo, uns, vic, xylo, Z </i>.
- Do not capitalize prefixes that are shown here as lowercase, even at the beginning of a sentence or in a title and never use lower case for those that are written in capital letters. Enclose the prefixes <i>E</i>, <i>R</i>, <i>R∗</i>, <i>S</i>, <i>S∗</i>, and <i>Z</i> in parentheses. <i>anti</i>-bicyclo[3.2.1]octan-8-amine, <i>ar</i>-chlorotoluene, <i>cis</i>-diamminedichloroplatinum, <i>cyclo</i>-hexasulfur, c-S6; (<i>E,E</i>)-2,4-hexadienoic acid; <i>m</i>-ethylpropylbenzene; <i>o</i>-dibromobenzene, <i>p</i>-aminoacetanilide; (<i>S</i>)-2,3-dihydroxypropanoic acid; 5-<i>sec</i>-butylnonane.
<b> Example: </b>: α-amino acid (not alpha amino acid); β-naphthol (not beta
naphthol); 5α,10β,15α,20α-tetraphenylporphyrin; 17β-Hydroxyandrost-4-en-3-on.
- Use italic type for positional, stereochemical, configurational, and descriptive structural prefixes when they appear with the chemical name or formula. Use a hyphen to separate them from the chemical name. <br />
<b> Examples: </b>: <i>
abeo, ac, altro, amphi, anti, antiprismo, ar, arachno, as, asym, c, catena,
cis, cisoid, closo, cyclo, d, dodecahedro, E, endo, erythro, exo, facgem,
hexahedro, hexaprismo, hypho, icosahedro, klado, l, m, M, mer, meso, n,
nido, o, octahedro, p, P, pentaprismo, quadro, r, R, R∗, rel, retro, ribo,
s, S, S∗, sec, sn, sym, syn, t, tert, tetrahedro, threo, trans, transoid,
triangulo, triprismo, uns, vic, xylo, Z
</i>.
- Do not capitalize prefixes that are shown here as lowercase, even at the beginning of a sentence or in a title and never use lower case for those that are written in capital letters. Enclose the prefixes <i>E</i>, <i>R</i>, <i>R∗</i>, <i>S</i>, <i>S∗</i>, and <i>Z</i> in parentheses. e.g. <i>anti</i>-bicyclo[3.2.1]octan-8-amine, <i>ar</i>-chlorotoluene, <i>cis</i>-diamminedichloroplatinum, <i>cyclo</i>-hexasulfur, c-S6; (<i>E,E</i>)-2,4-hexadienoic acid; <i>m</i>-ethylpropylbenzene; <i>o</i>-dibromobenzene, <i>p</i>-aminoacetanilide; (<i>S</i>)-2,3-dihydroxypropanoic acid; 5-<i>sec</i>-butylnonane.
- Multiplying affixes are integral parts of the chemical name; they are set in normal type and are always closed up to the rest of the name (without hyphens). Use hyphens only to set off intervening locants or descriptors. Use enclosing marks (parentheses, brackets, or braces) to ensure clarity or to observe other recommended nomenclature conventions. Multiplying prefixes include the following: <br />
<div style="text-indent:10px;">10px einzug</div> hemi, mono, di, tri, tetra, penta, hexa, hepta, octa, ennea, nona, deca, deka, undeca, dodeca, etc. <br />
<div style="text-indent:10px;">10px einzug</div> semi, uni, sesqui, bi, ter, quadri, quater, quinque, sexi, septi, octi, novi, deci, etc. <br />
<div style="text-indent:10px;">10px einzug</div> bis, tris, tetrakis, pentakis, hexakis, heptakis, octakis, nonakis, decakis, etc. <br />
<b>Examples: </b> 3,4′-bi-2-naphthol; 2,2′-bipyridine; bis(benzene)chromium(0); 1,4-bis(3-bromo-1-oxopropyl)piperazine; 1,3-bis(diethylamino)propane; di-tert-butyl malonate dichloride.


- hemi, mono, di, tri, tetra, penta, hexa, hepta, octa, ennea, nona, deca, deka, undeca, dodeca, etc. <br />
- semi, uni, sesqui, bi, ter, quadri, quater, quinque, sexi, septi, octi, novi, deci, etc. <br />
- bis, tris, tetrakis, pentakis, hexakis, heptakis, octakis, nonakis, decakis, etc. <br />
<b>Examples: </b> 3,4′-bi-2-naphthol; 2,2′-bipyridine; bis(benzene)chromium(0);
1,4-bis(3-bromo-1-oxopropyl)piperazine; 1,3-bis(diethylamino)propane; di-tert-butyl
malonate dichloride.

0 comments on commit 39a0db2

Please sign in to comment.