Webdoc issues
- [x] Code in multiple blocks is deprecated, e.g. `kvector_t` -> !1462 Observations by pages (some problems may have already been fixed): - [ ] https://bornagainproject.org/ old GUI screenshot - [x] https://bornagainproject.org/git-main/introduction/architecture/ mentions Qt5, old GUI screenshots - [ ] https://bornagainproject.org/git-main/installation/building/windows/ mentions Qt5 - [ ] https://bornagainproject.org/git-main/installation/building/unix/third-party/ mentions Qt5 - [x] https://bornagainproject.org/git-main/installation/building/unix/get-source/ mentions Github - [ ] https://bornagainproject.org/git-main/installation/building/unix/build-and-install/ `sudo make install` <-- DO NOT DO THIS `installation paths` <-- no installation anymore ``` $ cmake -DCMAKE_INSTALL_PREFIX=<install_dir> .. $ cmake -DCMAKE_PREFIX_PATH=/opt/local -DCMAKE_INSTALL_PREFIX=<install_dir> .. ``` `Installing the framework` <-- no installation anymore - [x] https://bornagainproject.org/git-main/gui/ Qt5 -->Qt6 Drag-and-drop interface description: > A graphical sample editor allows users to assemble multilayer models by drag-and-drop. Model components like embedded particles or inter-particle correlation functions are represented by boxes that are connected by flexible lines to their parent components. - [ ] https://bornagainproject.org/git-main/py/ `Installing the Python package` <-- mv to `Installation` page? `Then read on to understand some example scripts line by line, and to discover further functionality` <-- The link should refer to https://bornagainproject.org/git-main/py/start/syntax/ - [x] https://bornagainproject.org/git-main/py/start/syntax/ No such blocks in code: ``` def get_sample(): from bornagain import std_samples return std_samples.alternating_layers() ``` ``` def get_simulation(sample, scan_size=500): from bornagain import std_simulations return std_simulations.specular(sample, scan_size) ``` `ba_plot.run_and_plot(simulation)` `The function run_and_plot is implemented in the module ba_plot.` <-- Wrong function name, broken link - [x] https://bornagainproject.org/git-main/py/start/modify-script/ `AlternatingLayers1.py from the preceding pages` <--- broken link `Instead of the shorthand calls to modules std_samples and std_simulations` <---- ??? `The function MaterialBySLD instantiates an object of type Material the function Layer an object of type Layer.` <--- of type material, not layer `get_simulation(sample, scan_size=500) is a function with one required argument (sample) and one optional keyword argument (scan_size). If the function is called with only one argument, then scan_size is assigned the default value 500.` <-- scan size is passed separately `angstrom and deg are numeric constants. They are used to convert physical quantities to internal units nanometer and radian.` <-- angstrom, not radian **I suggest to merge `Understand the syntax` and `Modify the script` pages.** - [x] https://bornagainproject.org/git-main/py/simulation/reflectometry/time-of-flight/ [now instr/scan/tof] Deprecated code ``` qzs = np.linspace(0.01, 1.0, scan_size) # qz-values scan = ba.QSpecScan(qzs) simulation = ba.SpecularSimulation() simulation.setScan(scan) ``` - [x] https://bornagainproject.org/git-main/py/simulation/reflectometry/tofr-with-resolution/ [now instr/scan/tof-resolution] Deprecated block ``` qzs = np.linspace(0.01, 1.0, scan_size) # qz-values dq = 0.03 * qzs n_sig = 2.0 n_samples = 25 distr = ba.RangedDistributionGaussian(n_samples, n_sig) scan = ba.QSpecScan(qzs) scan.setAbsoluteQResolution(distr, dq) simulation = ba.SpecularSimulation() simulation.setScan(scan) ``` Deprecated distribution names ``` Gate: RangedDistributionGate(n_samples, sigma_factor, min, max) Lorentz: RangedDistributionLorentz(n_samples, hwhm_factor, min, max) Gaussian: RangedDistributionGaussian(n_samples, sigma_factor, min, max) LogNormal: RangedDistributionLogNormal(n_samples, sigma_factor, min, max) Cosine: RangedDistributionCosine(n_samples, sigma_factor, min, max) ``` - [x] https://bornagainproject.org/git-main/py/simulation/gisas/ `TODO MOVE Explanation` - [x] https://bornagainproject.org/git-main/py/simulation/gisas/no-reflection/ Suggestion: rename page to "GISAS in Born Approximation". "No reflection" can be misunderstood. - [x] https://bornagainproject.org/git-main/py/simulation/gisas/gisas-with-specular/ deprecated syntax `simulation.getOptions().setIncludeSpecular(True)` - [x] https://bornagainproject.org/git-main/py/simulation/sas/polarized/ deprecated variable name ``` multiLayer = ba.MultiLayer() multiLayer.addLayer(solvent_layer) ``` - [ ] https://bornagainproject.org/git-main/py/sample/multilayer/ `TODO: Integrate content from reflectometry tutorial` - [x] https://bornagainproject.org/git-main/py/sample/avge/cylinders-in-average-layer/ https://bornagainproject.org/git-main/py/sample/avge/half-spheres-in-average-top-layer/ deprecated syntax `simulation.getOptions().setUseAvgMaterials(True)` - [x] https://bornagainproject.org/git-main/py/fitting/gisas-fit2d/ `Faked experimenta data` <-- typo `Faked experimental data have been generated by the script devtools/fakeData/fake-gisas1.py.` <-- broken link - [x] https://bornagainproject.org/git-main/py/fitting/advanced/fit-along-slices/ `Lines 55, 56, 57` <-- rm references to exact lines of code - [x] https://bornagainproject.org/git-main/py/fitting/advanced/find-background/ `at line 42` <-- rm references to exact lines of code - [x] https://bornagainproject.org/git-main/py/fitting/advanced/multiple-datasets/ `At lines 171-145` <-- rm references to exact lines of code - [x] https://bornagainproject.org/git-main/py/fitting/importing-experimental-data/ deprecated syntax? `data = ba.IntensityDataIOFactory.readIntensityData("experimental_data.int.gz").array()`
issue