path: root/man/wmap.1

.TH WMAP 1 "2025-12-17" "1.0.0" "Wmap Manual"
.SH NAME
wmap \- generate wardley map images from wmap files.
.SH SYNOPSIS
.B wmap [\fIOPTIONS\fP] \fIINPUT_FILE\fP
.SH DESCRIPTION
.PP
wmap is a tool that lets you create png or scg images from a wmap formatted
file.
.SH OPTIONS
.TP
.B -h, --help
Display help.
.TP
.B -v, --version
Display version information.
.TP
.B -t, --type <\fIIMAGE_TYPE\fP>
Specifies the output type. Can be one of: \fIpng\fR, or \fIsvg\fR.
Defaults to \fIpng\fR.
.TP
.B -s, --stage <\fISTAGE\fP>
Specifies the stage labels to use. Defaults to \fIactivities\fR.
.TP
.B -o, --output <\fIOUTPUT_FILE\fP>
The output file in which to write the image. Defaults to the same filename as
the input map, but replacing the extension with either \fIpng\fR, or \fIsvg\fR.
.SH STAGES
The renderer has the following built-in sources available:
.SS Activities (\fIactivities\fP)
.TP
Genesis
.TP
Custom
.TP
Product (+rental)
.TP
Commodity (+utility)
.SS Behavior (\fIbehavior\fP)
.TP
Uncertain when to use
.TP
Learning when to use
.TP
Learning through use
.TP
Known / common usage
.SS Certainty (\fIcertainty\fP)
.TP
Poorly Understood / exploring the unknown
.TP
Rapid Increase In Learning / discovery becomes refining
.TP
Rapid increase in use / increasing fit for purpose
.TP
Commonly understood (in terms of use)
.SS Comparison (\fIcomparison\fP)
.TP
Constantly changing / a differential / unstable
.TP
Learning from others / testing the water / some evidential support
.TP
Competing models / feature difference / evidential support
.TP
Essential / any advantage is operational / accepted norm
.SS Cynefin (\fIcynefin\fP)
.TP
Chaotic
.TP
Complex
.TP
Complicated
.TP
Clear
.SS Data (\fIdata\fP)
.TP
Unmodelled
.TP
Divergent
.TP
Convergent
.TP
Modelled
.SS Decision Drivers (\fIdecision_drivers\fP)
.TP
Heritage / culture
.TP
Analyses & synthesis
.TP
Analyses & synthesis
.TP
Previous Experience
.SS Efficiency (\fIefficiency\fP)
.TP
Reducing the cost of change (experimentation)
.TP
Reducing cost of waste (Learning)
.TP
Reducing cost of waste (Learning)
.TP
Reducing cost of deviation (Volume)
.SS Failure (\fIfailure\fP)
.TP
High / tolerated / assumed to be wrong
.TP
Moderate / unsurprising if wrong but disappointed
.TP
Not tolerated / focus on constant improvement / assumed to be in the right direction / resistance to changing the model
.TP
Surprised by failure / focus on operational efficiency
.SS Focus Of Value (\fIfocus_of_value\fP)
.TP
High future worth but immediate investment
.TP
Seeking ways to profit and a ROI / seeking confirmation of value
.TP
High profitability per unit / a valuable model / a feeling of understanding / focus on exploitation
.TP
High volume / reducing margin / important but invisible / an essential component of something more complex
.SS Knowledge (\fIknowledge\fP)
.TP
Concept
.TP
Hypothesis
.TP
Theory
.TP
Accepted
.SS Knowledge Management (\fIknowledge_management\fP)
.TP
Uncertain
.TP
Learning on use / focused on testing prediction
.TP
Learning on operation / using prediction / verification
.TP
Known / accepted
.SS Market (\fImarket\fP)
.TP
Undefined Market
.TP
Forming Market / an array of competing forms and models of understanding
.TP
Growing Market / consolidation to a few competing but more accepted forms
.TP
Mature Market / stabilised to an accepted form
.SS Market Action (\fImarket_action\fP)
.TP
Gambling / driven by gut
.TP
Exploring a "found" value
.TP
Market analysis / listening to customers
.TP
Metric driven / build what is needed
.SS Market Perception (\fImarket_perception\fP)
.TP
Chaotic (non-linear) / domain of the "crazy"
.TP
Domain of "experts"
.TP
Increasing expectation of use / domain of "professionals"
.TP
Ordered (appearance of being linear) / trivial / formula to be applied
.SS Perception In Industry (\fIperception_in_industry\fP)
.TP
Future source of competitive advantage / unpredictable / unknown
.TP
Seen as a scompetitive advantage / a differential / ROI / case examples
.TP
Advantage through implementation / features / this model is better than that
.TP
Cost of doing business / accepted / specific defined models
.SS Practice (\fIpractice\fP)
.TP
Novel
.TP
Emerging
.TP
Good
.TP
Best
.SS Publication Types (\fIpublication\fP)
.TP
Describe the wonder of the thing / the discovery of some marvel / a new land / an unknown frontier
.TP
Focused on build / construct / awareness and learning / many models of explanation / no accepted forms / a wild west
.TP
Maintenance / operations / installation / comparison between competing forms / feature analysis
.TP
Focused on use / increasingly an accepted, almost invisible component
.SS Ubiquity (\fIubiquity\fP)
.TP
Rare
.TP
Slowly Increasing
.TP
Rapidly Increasing
.TP
Widespread in the applicable market / ecosystem
.SS Understanding (\fIunderstanding\fP)
.TP
Poorly Understood / unpredictable
.TP
Increasing understanding / development of measures
.TP
Increasing education / constant refinement of needs / measures
.TP
Believed to be well defined / stable / measurable
.SS User Perception (\fIuser_perception\fP)
.TP
Different / confusing / exciting / surprising / dangerous
.TP
Leading edge / emerging / unceirtanty over results
.TP
Increasingly common / disappointed if not used or available / feeling left behind
.TP
Standard / expected / feeling of shock if not used
.SS Evolution Stage (\fIevolution_stage\fP)
.TP
tage I
.TP
Stage II
.TP
Stage III
.TP
Stage IV"
.SH VERSION
.BR 1.0.0
.SH HOMEPAGE
.I https://map.tranquil.systems/cli
.SH AUTHORS
\ Rubén Beltrán del Río <\fImap@r.bdr.sh\fP>