CZ:Code: Difference between revisions
imported>Dmitrii Kouznetsov |
Pat Palmer (talk | contribs) mNo edit summary |
||
(12 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
{{NoLongerApplies}} | |||
This page contains standards and regulations related to Code [[CZ:Subpages|subpages]]. | This page contains standards and regulations related to Code [[CZ:Subpages|subpages]]. | ||
== What are Code pages? == | == What are Code pages? == | ||
In these pages, users should upload the codes used to create CZ articles; especially tables and images. | In these pages, users should upload the codes used to create CZ articles; especially tables and images. | ||
The code can be a scrypt designed for some specific [[operation system]] interface, as well as source in some of widely used [[programming language]]s: [[Postscript]], [[ | The code can be a scrypt designed for some specific [[operation system]] interface, as well as source in some of widely used [[programming language]]s: [[Postscript]], [[LaTeX]], [[Mathematica]], [[Maple]], [[Matlab]], [[C++]], [[Fortran]], [[Assembler]], etc. | ||
== Purpose == | == Purpose == | ||
Long pieces of code are usually next to useless in a general purpose encyclopaedia. | |||
Short codes can be used as a complement (but not a substitute) of the description of the figure, | |||
allowing to understand all the details: what is plotted and how it is plotted. | |||
Therefore, the codes should be optimized for their length and human readability (not for CPU time). | |||
The code should allow a user to reproduce the figure and to modify it. | |||
<!-- | |||
Therefore, it is preferable, that the code has no input files and and the only one output file; namely, the figure. | |||
!--> | |||
== Heading and format standards == | == Heading and format standards == | ||
Usually, the code is easier to read, if it is formatted as sequence of lines. In order to provide such formatting, each new line should begin with spacebar (character with decimal ascii number 32). | Usually, the code is easier to read, if it is formatted as sequence of lines. In order to provide such formatting, each new line should begin with spacebar (character with decimal [[ascii]] number 32). | ||
At the header, it desirable to specify, what does the code do. It may be good idea, to specify the header as a "comment" in such a way, that it has no need to be removed before the compillation or execution of the code. All the codes are supposed to be in ascii; special unicode characters are allowed only if their use is essential, for example, illustrating a text in a foreign language. | At the header, it desirable to specify, what does the code do. It may be good idea, to specify the header as a "comment" in such a way, that it has no need to be removed before the compillation or execution of the code. All the codes are supposed to be in ascii; special unicode characters are allowed only if their use is essential, for example, illustrating a text in a foreign language. | ||
In particular, the Mathematica and Maple codes should be converted to ascii (plain text) before saving. | In particular, the Mathematica and Maple codes should be converted to [[ascii]] (plain text) before saving. | ||
== Guidelines for editing == | == Guidelines for editing == | ||
Editing of codes after the last test-run is not recommended at all. Small error (for example, O instead of 0, or I instead of |, any specific [[unicode character]] that look identical to some [[ascii character]]) may affect the execution of code, while is difficult to detect at the visual revision. | Editing of codes after the last test-run is not recommended at all. Small error (for example, O instead of 0, or I instead of |, any specific [[unicode character]] that look identical to some [[ascii character]]) may affect the execution of code, while is difficult to detect at the visual revision. | ||
Line 35: | Line 45: | ||
==List of codepages with sources downloaded== | ==List of codepages with sources downloaded== | ||
== | *[[AnalyticTetrationBaseSqrt2v00/code]] C++ generator of [[contour plot]] of analytic [[tetration]] with base <math>\sqrt{2}</math> | ||
*[[AnalyticTetrationBaseSqrt2u00/code]] C++ generator of [[contour plot]] of modified [[tetration]] with base <math>\sqrt{2}</math> | |||
*[[ContourPlot/code/ado.cin]] C++ function that makes the "minimal" header for the [[EPS file]]. | |||
*[[ContourPlot/code/conto.cin]] C++ function that draws the level f=const from the table of function f. | |||
*[[ExampleEquationLog01]] , C++ generator of plot of [[linear function]] and three [[logarithmic function]]s | |||
*[[FixedPointsLoge00/code]] , [[Mathematica]] generator of plots of [[fixed points]] of log and exp | |||
*[[SLOGappro50.jpg/code]] , C++ generator of plot of approcimation of [[superlogatirhm]] with the elementaty function | |||
*[[SlogFitFixedPoint04.jpg/code]] , [[Maple (software)|Maple]] and [[Mathematica]] codes that calculate of the coefficients of the asymptotic expansion of the [[superlogarithm]]. | |||
*[[TaylorExampleZ/code]] , C++ generator of plot of truncated Taylor series for function 1/z in the complex z-plane | |||
*[[TetrationAsymptoticParameters00]] , C++ generator of [[contour plot]] of asymptotic parameters of analytic [[tetration]] <math>F_b</math> versus <math>\ln(b)</math>. | |||
==Imges that use the downloadable codes== | |||
===Graphics of [[function]]s=== | |||
====Simple plots ([[explicit plot]]s)==== | |||
[[Image:ExampleEquationLog01.png|100px]] | |||
[[Image:TetrationAsymptoticParameters01.jpg|160px]] | |||
====[[Contour plot]]s ([[implicit plot]]s)==== | |||
[[Image:ContourPlotExample.jpg|130px]] | |||
[[Image:AnalyticTetrationBaseSqrt2v00.jpg|120px]] | |||
[[Image:AnalyticTetrationBaseSqrt2u00.png|120px]] | |||
[[Image:FixedPointsLoge00.png|160px]] | |||
[[Image:FixedPointsExpe00.jpg|100px]] | |||
[[Image:TaylorExampleZ.jpg|400px]] | |||
[[Image:SLOGappro50.jpg|160px]] | |||
===Generators of tables=== | |||
===Scientific schemes and diagrams=== | |||
===Other codes=== | |||
<br> | <br> | ||
Back to [[CZ:Subpages|Subpages]] | Back to [[CZ:Subpages|Subpages]] |
Latest revision as of 14:36, 26 January 2023
The information on the page below is likely OBSOLETE |
At least some of this information applied to an older way of operating The wiki's policies and rules are now linked to the main page at Welcome_to_Citizendium. |
This page contains standards and regulations related to Code subpages.
What are Code pages?
In these pages, users should upload the codes used to create CZ articles; especially tables and images. The code can be a scrypt designed for some specific operation system interface, as well as source in some of widely used programming languages: Postscript, LaTeX, Mathematica, Maple, Matlab, C++, Fortran, Assembler, etc.
Purpose
Long pieces of code are usually next to useless in a general purpose encyclopaedia. Short codes can be used as a complement (but not a substitute) of the description of the figure, allowing to understand all the details: what is plotted and how it is plotted. Therefore, the codes should be optimized for their length and human readability (not for CPU time). The code should allow a user to reproduce the figure and to modify it.
Heading and format standards
Usually, the code is easier to read, if it is formatted as sequence of lines. In order to provide such formatting, each new line should begin with spacebar (character with decimal ascii number 32). At the header, it desirable to specify, what does the code do. It may be good idea, to specify the header as a "comment" in such a way, that it has no need to be removed before the compillation or execution of the code. All the codes are supposed to be in ascii; special unicode characters are allowed only if their use is essential, for example, illustrating a text in a foreign language. In particular, the Mathematica and Maple codes should be converted to ascii (plain text) before saving.
Guidelines for editing
Editing of codes after the last test-run is not recommended at all. Small error (for example, O instead of 0, or I instead of |, any specific unicode character that look identical to some ascii character) may affect the execution of code, while is difficult to detect at the visual revision.
Content Policy
The proof of significance of a code is that it generates some content, used in CZ. It is desirable to indicate, what pictures of tables were generated using the code. If used many times, it may worth to indicate the tree. Such a specification may look like a poem This Is the House That Jack Built, being something like this:
- This code is Programs/FFT/simple/FFT.cin
- That is used as a function, is inputted in
- Programs/FFT/example.cc to generate the file
- File:Fast Fourier Transform figure 3version02.jpg that is used, for a while
- by the Fast Fourier Transform
- by Fourier Analysis
- by Periodic Functions
- File:Fast Fourier Transform figure 3version02.jpg that is used, for a while
- and by Table 1 in the article
... and so on. (Now some of files mentioned above are absent, but they may appear in future.)
Such an indication (if all clickable) makes it easy to check that the code is essential for the CZ, and without such a content, the encyclopedy cannot be considered as self-consistent.
List of codepages with sources downloaded
- AnalyticTetrationBaseSqrt2v00/code C++ generator of contour plot of analytic tetration with base
- AnalyticTetrationBaseSqrt2u00/code C++ generator of contour plot of modified tetration with base
- ContourPlot/code/ado.cin C++ function that makes the "minimal" header for the EPS file.
- ContourPlot/code/conto.cin C++ function that draws the level f=const from the table of function f.
- ExampleEquationLog01 , C++ generator of plot of linear function and three logarithmic functions
- FixedPointsLoge00/code , Mathematica generator of plots of fixed points of log and exp
- SLOGappro50.jpg/code , C++ generator of plot of approcimation of superlogatirhm with the elementaty function
- SlogFitFixedPoint04.jpg/code , Maple and Mathematica codes that calculate of the coefficients of the asymptotic expansion of the superlogarithm.
- TaylorExampleZ/code , C++ generator of plot of truncated Taylor series for function 1/z in the complex z-plane
- TetrationAsymptoticParameters00 , C++ generator of contour plot of asymptotic parameters of analytic tetration versus .
Imges that use the downloadable codes
Graphics of functions
Simple plots (explicit plots)
Contour plots (implicit plots)
Generators of tables
Scientific schemes and diagrams
Other codes
Back to Subpages