F.1 Quick Ref#

[1] API#

API functions

API Function

Name

Purpose

rv.R (rS)

Run

Run scripts and markup

rv.I (rS)

Insert

Insert static sources

rv.V (rS)

Values

Calculate values

rv.T (rS)

Tools

Execute shell scripts and external programs

rv.D (rS)

Doc

Publish docs

rv.S;X (rS)

Skip

Skip section or exit (comments and debugging)

where rS is a rivt string. The first line of a rivt string (rS) is the header substring.

Header substrings

rv.I("""A New Section | private, doc, section

    Content text
    ...

    """)

Default settings in the header substring do not need to be specified. The default setting for each API is listed first (in bold) in the table below. The default privacy settings for all sections in a rivt file may be reversed by including the setpublic setting set to true immediately following the rivlib import statement. Individual sections may still be set as private in the header substring.

import rivtlib.rvapi as rv

# rv setpublic = true

Header substring defaults

API

private; public

doc; stored

section; merge

rv.R

private; public

stored; doc

merge; section

rv.I

private; public

doc; stored

section; merge

rv.V

private; public

doc; stored

section; merge

rv.T

private; public

stored; doc

merge; section

rv.S

private; public

stored

merge

rv.D

public

stored

merge

rv.X

[2] Line Tags#

Format a line of text

API Scope

Line Tag

Description

rv.I

text _[#] text

[6] Endnote number

rv.I

text _[D] label, filename | text

[3] Download link

rv.I

text _[G] glossary term | text

[7] Glossary link

rv.I

text _[S] label, section | text

[8] Section link

rv.I

text _[U] label, url | text

[9] URL link

rv.I

title _[T]

[11] Table number

rv.I,V

caption _[F]

[12] Figure number

rv.I,V

text _[C]

[2] Bold center text

rv.I,V

text math _[M] description

[4] Text math

rv.I,V

LaTeX math _[L] description

[5] LaTeX math

rv.I,V

text _[V] var_name | text

[10] Variable value

all

## text

nonprinting comment

[3] Block Tags#

Format or run blocks of text or code ========== ========================================= =============================== API Scope Block Tag Description ========== ========================================= =============================== rv.R _[[MARKUP]] type [8] Markup block rv.R _[[PYTHON]] label [7] Python rv.I _[[BOX]] label [6] Box rv.I _[[TOPIC]] topic [5] Topic rv.V _[[TABLE]] label [4] Table Block rv.T _[[SHELL]] os, wait;nowait [2] Shell script rv.D _[[METADATA]] label [9] Metadata all _[[END]] [10] End block ========== ========================================= ===============================

[4] Commands#

Read, write and format files

API Scope

Command

Description

rv.R
MARKUP | rel path | type

[12] Markup file

rv.I, V
TABLE | rel path | title,width,rows,

[4] Table file

rv.I, V
IMAGE | rel path | caption, scale, num;non

[5] Image file

rv.I, V
IMAGE2 | rel pth1, rel pth2 | cap1,cap2,sc1,sc2,num,num

[6] Adjacent images

rv.V
VALTABLE | rel path | title, rows

[7] Valtable file

rv.V
PYTHON | rel path | description

[11] Python file

rv.V

a ==: 1*IN | unit1, unit2, decimal | description

[8] Define value

rv.V

c <=: expression | unit1, unit2, decimal | description

[9] Assign value

rv.V

c :=: function(x,y) | unit1, unit2, decimal | description

[9] Function value

rv.V

a < c | unit, decimal, text1, text2 | description

[10] Compare values

rv.T
SHELL | rel path | os, wait;nowait

[2] Shell file

rv.D
ATTACHPDF | rel path | place, title

[13] Attach PDF

rv.D
PUBLISH | doc title | type

[14] Publish doc

Relative file paths for commands

Command

Default Path

R/W

| SHELL |

/rvsrc/

R

| IMAGE |

/rvsrc/

R

| IMAGE2 |

/rvsrc/

R

| VALTABLE |

/rvsrc/ [1]

R

| PYTHON |

/rvsrc/

R

| MARKUP |

/rvsrc/

R

| ATTACHPDF |

/rvsrc/

W

| PUBLISH |

/_published/ [2]

W

[1] use /rv_stor/ to read values written by rivt [2] files are written to the respective type subdirectory

[5] Folders#

[rivt-]Report-Label/             rivt Folder
    ├── .vscode/                      optional VSCode settings
    ├── README.txt                    rivt-generated text report
    ├── [_rivt-public]/               rivt-generated public files
        ├── rvsrc/                        author source files
        ├── rv-101-filename1.py           public rivt file
        ├── rv-102-filename2.py           public rivt file
        ├── rv-201-filename3.py           public rivt file
         ...
    └── [rivt-report]/                 report folder
            ├── [rv101-]filename1.py          rivt file
            ├── [rv102-]filename2.py          rivt file
            ├── [rv201-]filename3.py          rivt file
            ├── [rv202-]filename4.py          rivt file
             ...
            ├── [rvsrc]                     author source files and folders
                ├── down/                      files to download
                    └── conc-vals.txt
                ├── data/                       tables
                    └── steel-vals.csv
                ├── run/                        scripts and functions
                    └── plot.py
                ├── tools/                      OS shell commands
                    └── opensees.sh
                ├── fig1.png
                └── fig2.jpg
            ├── [rv_stor]/                     rivt-generated source files
                ├── [logs]/                         log files
                    ├── rv101-log.txt
                    └── rv102-log.txt
                ├── [sect]/                          sections not printed
                    ├── rv202-5d.txt
                    ├── rv103-4t.txt
                    └── rv301-2r.txt
                ├── [temp]/                          temp files
                    └── rv101-label3.tex
                ├── output.dat
                ├── v101-2.csv
                └── v102-3.csv
            ├── [_published]/                   published docs and reports
                ├── [docs]/                       html docs
                    ├── html auxiliary files
                     ...
                    ├── index.html
                    ├── rv101-filename1.html
                    ├── rv102-filename2.html
                    ├── rv201-filename3.html
                     ...
                ├── [pdfdocs]/                      pdf docs
                    ├── pdf auxiliary files
                     ...
                    ├── report-title.pdf
                    ├── rv101-filename1.pdf
                    ├── rv102-filename1.pdf
                    ├── rv201-filename3.pdf
                    ...
                └── [txtdocs]/                      text docs
                    ├── report-title.txt
                    ├── rv101-filename1.txt
                    ├── rv102-filename1.txt
                    ├── rv201-filename3.txt
                    ...
            ├── [_rstdocs]/                       restructured text files
                ├── _downloads/
                ├── _static/
                ├── _locale/
                ├── rv101-filename1.rst
                ├── rv102-filename2.rst
                ├── rv201-filename3.rst
                ...

[6] Python Requirements#

The minimum Python version is 3.14. rivt project packages include the following categories:

  • formatting

  • numerical analysis

  • symbolic processing

  • visualization

  • IDE

Dependency

description

“pyzo>=4.20.0”

lightweight IDE

“pyside6>=6.10.1”

QT bindings

“fastcore>=1.8.16”

code simplification

“tabulate>=0.9.0”

format tables

“pillow>=11.2.1”

image processing

“matplotlib>=3.10.1”

data visualization

“sympy>=1.13.3”

symbolic analysis

“numpy>=2.2.5”

numerical analysis

“scipy>=1.16.3”

numerical analysis

“pandas>=2.2.3”

data analysis

“docutils>=0.21.2”

reStructuredText processing

“ipython>=8.16.2”

interactive Python shell

“ipykernel>=6.28.1”

Jupyter kernel for Python

“reportlab>=4.4.0”

PDF generation without LaTeX

“rst2pdf>=0.103.1”

PDF generation without LaTeX

“pypdf>=1.0.3”

PDF manipulation

“Sphinx>=8.2.3”

HTML generation

“pydata-sphinx-theme>=0.16.1”

HTML generation

“sphinx-copybutton>=0.5.2”

HTML generation

“sphinx_design>=0.6.1”

HTML generation

“sphinx-favicon>=1.0.1”

HTML generation

“sphinx-togglebutton>=0.3.2”

HTML generation

“sphinxcontrib-applehelp>=2.0.0”

HTML generation

“sphinxcontrib-devhelp>=2.0.0”

HTML generation

“sphinxcontrib-email>=0.3.6”

HTML generation

“sphinxcontrib-htmlhelp>=2.1.0”

HTML generation

“sphinxcontrib-jquery>=4.1”

HTML generation

“sphinxcontrib-jsmath>=1.0.1”

HTML generation

“sphinxcontrib-qthelp>=2.0.0”

HTML generation

“sphinxcontrib-serializinghtml>=2.0.0”

HTML generation

[7] VSCode Settings#

Workspace extension and other settings are stored in the .vscode folder and should be included as part of a rivt folder. Settings that affect the rivt editing and execution environment incldue:

  • rivt.code-snippets

  • settings.json (extension settings)

  • tasks.json

  • launch.json

Global settings can be exported and imported using VSCode Profiles. VSCode rivt extensions and settings may be installed from this link.

Extension

description

BUTTONS

—

tombonnike.vscode-status-bar-format-toggle

format button

gsppvo.vscode-commandbar

command buttons

AdamAnand.adamstool

command buttons

nanlei.save-all

save all button

Ho-Wan.setting-toggle

toggle settings

yasukotelin.toggle-panel

toggle panel

fabiospampinato.vscode-commands

user command buttons

jerrygoyal.shortcut-menu-bar

menu bar

EDITING

—

henryclayton.context-menu-toggle-comments

toggle comments

TroelsDamgaard.reflow-paragraph

wrap paragraph

streetsidesoftware.code-spell-checker

spell check

jmviz.quote-list

quote elements in a list

njpwerner.autodocstring

insert doc string

oijaz.unicode-latex

unicode symbols from latex

jsynowiec.vscode-insertdatestring

insert date string

janisdd.vscode-edit-csv

csv editor

VIEWS

—

GrapeCity.gc-excelviewer

excel viewer

SimonSiefke.svg-preview

svg viewer

tomoki1207.pdf

pdf viewer

RandomFractalsInc.vscode-data-preview

data viewing tools

Fr43nk.seito-openfile

open file from path

vikyd.vscode-fold-level

line folding tool

file-icons.file-icons

icon library

tintinweb.vscode-inline-bookmarks

inline bookmarks

MANAGEMENT

—

alefragnani.project-manager

folder, project management

Anjali.clipboard-history

clipboard history

dionmunk.vscode-notes

notepad

hbenl.vscode-test-explorer

test explorer

mightycoco.fsdeploy

save file to second location

lyzerk.linecounter

count lines in files

sandcastle.vscode-open

open files in default app

zjffun.snippetsmanager

snippet manager

spmeesseman.vscode-taskexplorer

task explorer

GITHUB

—

GitHub.codespaces

run files in codespaces

GitHub.remotehub

run remote files

ettoreciprian.vscode-websearch

search github within VSCode

donjayamanne.githistory

git history

MichaelCurrin.auto-commit-msg

git auto commit message

github.vscode-github-actions

github actions

GitHub.vscode-pull-request-github

github pull request

k9982874.github-gist-explorer

gist explorer

vsls-contrib.gistfs

gist tools

PYTHON

—

ms-python.autopep8

python pep8 formatting

ms-python.isort

python sort imports

donjayamanne.python-environment-manager

python library list

ms-python.python

python tools

ms-python.vscode-pylance

python language server

ms-toolsai.jupyter

jupyter tools

ms-toolsai.jupyter-keymap

jupyter tools

ms-toolsai.jupyter-renderers

jupyter tools

ms-toolsai.vscode-jupyter-cell-tags

jupyter tools

ms-toolsai.vscode-jupyter-slideshow

jupyter tools

LANGUAGES

—

qwtel.sqlite-viewer

sqlite tools

RDebugger.r-debugger

R tools

REditorSupport.r

R tools

ms-vscode-remote.remote-wsl

windows linux tools

James-Yu.latex-workshop

latex tools

lextudio.restructuredtext

restructured text tools

trond-snekvik.simple-rst

restructured syntax

yzane.markdown-pdf

markdown to pdf

yzhang.markdown-all-in-one

markdown tools

Snippets and extensions

Keystrokes

Description

rvr

API Run

rvi

API Insert

rvv

API Values

rvt

API Tools

rvd

API Docs

alt+ctrl+c

insert cell marker with label above API function

alt+q

rewrap paragraph with hard line feeds (80 default)

alt+p

open file under cursor

alt+.

select correct spelling under cursor

alt+8

insert date

alt+9

insert time

ctl+1

focus on first editor

ctl+2

focus on next editor

ctl+3

focus on previous editor

ctl+8

focus on explorer pane

ctl+9

focus on github pane

ctl+alt+x

reload window

ctl+alt+[

reload window

ctl+alt+]

unfold all code

ctl+alt+u

unfold all code

ctl+alt+f

fold code level 2 (rivt sections visible)

ctl+alt+a

fold code - all levels

ctl+alt+t

toggle local fold

ctl+alt+e

toggle explorer sort order

ctl+alt+s

toggle spell check

ctl+alt+g

next editor group

ctl+shift+u

open URL under cursor in browser

ctl+shift+s

open GitHub README search for rivt

ctl+shift+a

commit all

ctl+shift+z

commit the current editor

ctl+shift+x

post to remote

Modified Keyboard Shortcuts

Keystroke

Description

alt+q

rewrap paragraph with hard line feeds (80 default)

alt+p

open file under cursor

alt+.

select correct spelling under cursor

alt+8

insert date

alt+9

insert time

ctl+1

focus on first editor

ctl+2

focus on next editor

ctl+3

focus on previous editor

ctl+8

focus on explorer pane

ctl+9

focus on github pane

ctl+alt+x

reload window

ctl+alt+u

unfold all code

ctl+alt+f

fold code level 2 (rivt sections visible)

ctl+alt+a

fold code - all levels

ctl+alt+t

toggle local fold

ctl+alt+e

toggle explorer sort order

ctl+alt+s

toggle spell check

ctl+alt+g

next editor group

ctl+shift+u

open URL under cursor in browser

ctl+shift+s

open GitHub rivt README search

ctl+shift+a

commit all

ctl+shift+z

commit current editor

ctl+shift+x

post to remote