v1.8

asjadnaqvi · Sep 22, 2024 · b4423a6 · b4423a6
1 parent 50466e1
commit b4423a6
Show file tree

Hide file tree

Showing 40 changed files with 192 additions and 123 deletions.
diff --git a/CITATION.cff b/CITATION.cff
@@ -3,6 +3,6 @@ authors:
 - family-names: "Naqvi"
   given-names: "Asjad"
 title: "Stata package ``sankey''"
-version: 1.74
-date-released: 2024-06-11
+version: 1.8
+date-released: 2024-09-22
 url: "https://github.com/asjadnaqvi/stata-sankey"
diff --git a/README.md b/README.md
@@ -9,8 +9,8 @@
 
 ---
 
-# sankey v1.74
-(11 Jun 2024)
+# sankey v1.8
+(22 Sep 2024)
 
 This package allows users to draw Sankey plots in Stata. It is based on the [Sankey Guide](https://medium.com/the-stata-guide/stata-graphs-sankey-diagram-ecddd112aca1) published on [the Stata Guide](https://medium.com/the-stata-guide) on Medium on October 2021.
 
@@ -19,13 +19,13 @@ This package allows users to draw Sankey plots in Stata. It is based on the [San
 
 The package can be installed via SSC or GitHub. The GitHub version, *might* be more recent due to bug fixes, feature updates etc, and *may* contain syntax improvements and changes in *default* values. See version numbers below. Eventually the GitHub version is published on SSC.
 
-SSC (**v1.73**):
+SSC (**v1.74**):
 
 ```
 ssc install sankey, replace
 ```
 
-GitHub (**v1.74**):
+GitHub (**v1.8**):
 
 ```
 net install sankey, from("https://raw.githubusercontent.com/asjadnaqvi/stata-sankey/main/installation/") replace
@@ -63,13 +63,11 @@ graph set window fontface "Arial Narrow"
 The syntax for the latest version is as follows:
 
 ```stata
-sankey value [if] [in], from(var) to(var) 
-            [ by(var) palette(str) colorby(layer|level) colorvar(var) stock colorvarmiss(str) colorboxmiss(str)
-              smooth(1-8) gap(num) recenter(mid|bot|top) ctitles(list) ctgap(num) ctsize(num) ctposition(bot|top) 
-              ctcolor(str) labangle(str) labsize(str) labposition(str) labgap(str) showtotal labprop labscale(num) 
-              valsize(str) valcondition(num) format(str) valgap(str) novalues valprop valscale(num) wrap(num)
-              novalright novalleft nolabels sort1(value| name[, reverse]) sort2(value| order[, reverse])
-              lwidth(str) lcolor(str) alpha(num) offset(num) boxwidth(str) percent * ]
+sankey value [if] [in], from(var) to(var) [ by(var) palette(str) colorby(layer|level) colorvar(var) stock colorvarmiss(str) colorboxmiss(str) smooth(1-8) gap(num) 
+        recenter(mid|bot|top) ctitles(list) ctgap(num) ctsize(num) ctposition(bot|top)
+        ctcolor(str) labangle(str) labsize(str) labposition(str) labgap(str) showtotal labprop labscale(num) valsize(str) valcondition(num) format(str) valgap(str) 
+		novalues valprop valscale(num) novalright novalleft nolabels 
+		sort1(value|name[, reverse]) sort2(value|order[, reverse]) align fill lwidth(str) lcolor(str) alpha(num) offset(num) boxwidth(str) percent wrap(num) * ]
 ```
 
 See the help file `help sankey` for details.
@@ -94,15 +92,15 @@ Software packages take countless hours of programming, testing, and bug fixing.
    author = {Naqvi, Asjad},
    title = {Stata package ``sankey''},
    url = {https://github.com/asjadnaqvi/stata-sankey},
-   version = {1.74},
-   date = {2024-06-11}
+   version = {1.8},
+   date = {2024-09-22}
 }
 ```
 
 *or simple text*
 
 ```
-Naqvi, A. (2024). Stata package "sankey" version 1.74. Release date 11 June 2024. https://github.com/asjadnaqvi/stata-sankey.
+Naqvi, A. (2024). Stata package "sankey" version 1.8. Release date 22 September 2024. https://github.com/asjadnaqvi/stata-sankey.
 ```
 
 
@@ -450,6 +448,12 @@ Please open an [issue](https://github.com/asjadnaqvi/stata-sankey/issues) to rep
 
 ## Change log
 
+**v1.8 (22 Sep 2024)**
+- Added option `align` to align flows. Works only if there is just one parent (still beta).
+- Added option `fill` to extrapolate missing flows. Works only if there is just one parent (still beta).
+- Added option `n()` to allow users to increase the number of points for generating the arcs. Default is 30.
+- Quite a large code clean up so the command should run a bit faster.
+
 **v1.74 (11 Jun 2024)**
 - Added `wrap()` option for wrapping labels.
 - Minor code cleanups.

diff --git a/figures/sankey1.png b/figures/sankey1.png
diff --git a/figures/sankey2_1.png b/figures/sankey2_1.png
diff --git a/figures/sankey2_2.png b/figures/sankey2_2.png
diff --git a/figures/sankey3_1.png b/figures/sankey3_1.png
diff --git a/figures/sankey3_2.png b/figures/sankey3_2.png
diff --git a/figures/sankey4_1.png b/figures/sankey4_1.png
diff --git a/figures/sankey4_2.png b/figures/sankey4_2.png
diff --git a/figures/sankey5.png b/figures/sankey5.png
diff --git a/figures/sankey5_1.png b/figures/sankey5_1.png
diff --git a/figures/sankey5_2.png b/figures/sankey5_2.png
diff --git a/figures/sankey5_2_1.png b/figures/sankey5_2_1.png
diff --git a/figures/sankey5_2_2.png b/figures/sankey5_2_2.png
diff --git a/figures/sankey5_2_3.png b/figures/sankey5_2_3.png
diff --git a/figures/sankey5_3.png b/figures/sankey5_3.png
diff --git a/figures/sankey5_4.png b/figures/sankey5_4.png
diff --git a/figures/sankey5_5.png b/figures/sankey5_5.png
diff --git a/figures/sankey6.png b/figures/sankey6.png
diff --git a/figures/sankey6_1.png b/figures/sankey6_1.png
diff --git a/figures/sankey6_10.png b/figures/sankey6_10.png
diff --git a/figures/sankey6_2.png b/figures/sankey6_2.png
diff --git a/figures/sankey6_3.png b/figures/sankey6_3.png
diff --git a/figures/sankey6_4.png b/figures/sankey6_4.png
diff --git a/figures/sankey6_5.png b/figures/sankey6_5.png
diff --git a/figures/sankey6_6.png b/figures/sankey6_6.png
diff --git a/figures/sankey6_7.png b/figures/sankey6_7.png
diff --git a/figures/sankey6_8.png b/figures/sankey6_8.png
diff --git a/figures/sankey6_9.png b/figures/sankey6_9.png
diff --git a/figures/sankey7.png b/figures/sankey7.png
diff --git a/figures/sankey8_1.png b/figures/sankey8_1.png
diff --git a/figures/sankey8_2.png b/figures/sankey8_2.png
diff --git a/figures/sankey8_3.png b/figures/sankey8_3.png
diff --git a/figures/sankey8_4.png b/figures/sankey8_4.png
diff --git a/figures/sankey9_1.png b/figures/sankey9_1.png
diff --git a/figures/sankey9_2.png b/figures/sankey9_2.png