Skip to content

Commit 5a4c547

Browse files
tarumataruma
authored
feidlambda docs & final updates (#38)
1 parent 84cbe2a commit 5a4c547

9 files changed

Lines changed: 127 additions & 21 deletions

File tree

‎_feidlambda/feid_.sc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -306,7 +306,7 @@ _RECURSIVE_LOOKUP = LAMBDA(
306306
)
307307
);
308308

309-
// GET_RECURSIVE_LOOKUP --> GET_XLOOKUP
309+
// _RECURSIVE_LOOKUP --> GET_XLOOKUP
310310
GET_XLOOKUP = LAMBDA(
311311
lookup_value,
312312
lookup_vector,

‎_feidlambda/feid_GET.sc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ _RECURSIVE_LOOKUP = LAMBDA(
6565
)
6666
);
6767

68-
// GET_RECURSIVE_LOOKUP --> GET_XLOOKUP
68+
// _RECURSIVE_LOOKUP --> GET_XLOOKUP
6969
GET_XLOOKUP = LAMBDA(
7070
lookup_value,
7171
lookup_vector,

‎docs/install.qmd‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ subtitle: |
55
Panduan pemasangan koleksi feidlambda menggunakan Excel Labs: Advanced Formula Environment.
66
author: Taruma Sakti Megariansyah
77
date: 2022-10-20
8-
date-modified: 2023-05-19
8+
date-modified: 2023-05-26
99
date-format: full
1010
lang: id
1111

‎release/excel/RELEASE_feidlambda_v0_4_0.xlsx‎

88.7 KB
Binary file not shown.

‎release/excel/RELEASE_feidmath_v0_1_0.xlsx‎

111 KB
Binary file not shown.

‎release/feidlambda-0-4.qmd‎

Lines changed: 116 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -39,10 +39,14 @@ aliases:
3939
```default
4040
https://gist.github.com/taruma/b4df638ecb7af48ab63691951481d6b2
4141
```
42-
4342
:::
4443

45-
**Panduan instalasi feidlambda dapat dilihat di halaman [Penggunaan](/docs/install.qmd).**
44+
::: {.text-center}
45+
46+
[<button type="button" class="btn btn-info m-1">INSTALASI</button>](/docs/install.qmd)
47+
[<button type="button" class="btn btn-primary m-1">WORKSHEET FEIDLAMBDA v0.4.0</button>](https://github.com/fiakoenjiniring/feidlambda/releases/download/v0.4.0/RELEASE_feidlambda_v0_4_0.xlsx)
48+
49+
:::
4650

4751
feidlambda v0.4 merupakan pengembangan lebih lanjut dari versi v0.3 sehingga fitur/fungsi yang telah tersedia di feidlambda v0.3 tersedia di versi feidlambda v0.4. Dan dengan dirilisnya feidlambda v0.4, tersedia paket feidlambda baru bernama `feidmath`. feidmath v0.1 merupakan kumpulan fungsi LAMBDA yang fokus menyelesaikan beberapa permasalahan matematika seperti perkalian matriks, rotasi, interpolasi, dlsbnya. [Kunjungi halaman rilis feidmath](feidmath-0-1.qmd).
4852

@@ -52,13 +56,29 @@ feidlambda v0.4 merupakan pengembangan lebih lanjut dari versi v0.3 sehingga fit
5256

5357
:::
5458

59+
# Update Log v0.4.x {#update-log}
60+
61+
_Update Log_ merupakan catatan pembaruan feidlambda. Berikut catatan perubahan/pembaruan secara umum beserta penjelasan perubahan/pembaruan. Untuk perubahan berdasarkan fungsinya, bisa dilihat di bagian [_Changelog_](#changelog).
62+
63+
- **Update v0.4.0 (2023-05-26)**
64+
- Kategori baru bernama `APPLY_*`.
65+
- Fungsi baru `APPLY_COLUMN()` yang dapat digunakan untuk menerapkan fungsi LAMBDA pada kolom tertentu di dataset.
66+
- Fungsi baru di kategori `GET_*`:
67+
- Fungsi baru `GET_XLOOKUP()` yang merupakan fungsi peningkatan dari fungsi bawaan `XLOOKUP()`. Fungsi `GET_XLOOKUP()` menerima input vector.
68+
69+
::: {.column-screen-inset-shaded}
70+
71+
---
72+
73+
:::
74+
5575
# Fungsi feidlambda v0.4.x {#sec-feid-v04}
5676

5777
Pada feidlambda v0.4.x, setiap fungsi dikategorikan sesuai kegunaannya. Berikut kategori yang tersedia di feidlambda v0.4.x:
5878

5979
- [NEW]{.f-new} `APPLY_*`: Memanipulasi data dengan menerapkan fungsi pada subset atau kolom tertentu.
6080
- `FILTER_*`: Melakukan _filtering_ atau _subsetting_ (memilah) dari data.
61-
- `GET_*`: Mengambil informasi dari data.
81+
- [NEW]{.f-new} `GET_*`: Mengambil informasi dari data.
6282
- `IS_*`: Fungsi _logical_ tambahan.
6383
- `MAKE_*`: Membangkitkan data.
6484
- `REPEAT_*`: Mengulangi/merepetisi data.
@@ -90,23 +110,49 @@ Gambar yang ditampilkan pada halaman ini terdapat dari versi sebelumnya (feidlam
90110
%%{ init: { 'theme': 'forest' } }%%
91111
92112
flowchart LR
93-
NONE --> FILTER_DROP_ROWS
94-
NONE --> FILTER_DROP_COLUMNS
95-
NONE --> FILTER_FUNC_COLUMN
96-
FILTER_FUNC_COLUMN --> FILTER_MINMAX_COLUMN
97-
FILTER_MINMAX_COLUMN --> _RECURSIVE_FILTER_MINMAX
98-
_RECURSIVE_FILTER_MINMAX --> _RECURSIVE_FILTER_MINMAX
99-
_RECURSIVE_FILTER_MINMAX --> FILTER_MINMAX_ARRAY
113+
NONE --> APPLY_COLUMN
100114
```
101115

102116
Fungsi utama kategori `APPLY_*` yaitu `APPLY_COLUMN()`.
103117

104118
<details>
105-
<summary>_Source Code_ `FILTER_*`</summary>
106-
```{.scala include="../_feidlambda/feid_FILTER.sc" }
119+
<summary>_Source Code_ `APPLY_*`</summary>
120+
```{.scala include="../_feidlambda/feid_APPLY.sc" }
107121
```
108122
</details>
109123

124+
### `APPLY_COLUMN()` {#sec-apply-column}
125+
126+
[NEW v0.4]{.f-new} Fungsi `APPLY_COLUMN(array, index_vector, LAMBDA_FUNCTION)` digunakan untuk menerapkan fungsi LAMBDA (`LAMBDA_FUNCTION()`) pada kolom tertentu di dalam _array_.
127+
128+
::::: {.border .p-3 .my-3 .justify}
129+
130+
::: {.text-center .syntax}
131+
_Syntax_
132+
: APPLY_COLUMN(array, index_vector, LAMBDA_FUNCTION)
133+
134+
_Output_
135+
: _array_
136+
:::
137+
138+
---
139+
140+
`array := [array]`
141+
: Data berupa _array_ yang memiliki kolom lebih dari satu.
142+
143+
`index_vector := [integer number | integer vector]`
144+
: Indeks kolom yang ingin diterapkan fungsi lambda.
145+
146+
`LAMBDA_FUNCTION := [LAMBDA FUNCTION]`
147+
: Fungsi LAMBDA yang ingin diterapkan pada kolom. Fungsi harus berupa formula LAMBDA (`=LAMBDA(...)`). Dapat berupa nama fungsi atau formula LAMBDA.
148+
149+
:::::
150+
151+
::: {.column-page-left}
152+
![Demonstrasi `APPLY_COLUMN()`](img-0-4-0/feidlambda-APPLY-01.gif){#fig-apply-column}
153+
:::
154+
155+
110156
::: {.column-screen-inset-shaded}
111157

112158
---
@@ -260,9 +306,11 @@ Kategori `GET_*` merupakan kumpulan fungsi yang digunakan untuk mengambil inform
260306
261307
flowchart LR
262308
NONE --> GET_INDEX_2D
309+
_RECURSIVE_LOOKUP --> _RECURSIVE_LOOKUP
310+
_RECURSIVE_LOOKUP --> GET_XLOOKUP
263311
```
264312

265-
Dari @fig-dep-get, diketahui untuk versi v0.3 hanya tersedia fungsi `GET_INDEX_2D()`.
313+
Dari @fig-dep-get, diketahui untuk versi v0.4 tersedia fungsi utama `GET_INDEX_2D()` dan `GET_XLOOKUP()`.
266314

267315
<details>
268316
<summary>_Source Code_ `GET_*`</summary>
@@ -303,6 +351,60 @@ _Output_
303351
![Demonstrasi `GET_INDEX_2D()`](img-0-3-0/feidlambda-v03-02-get-1.gif){#fig-get-index-2d}
304352
:::
305353

354+
### `GET_XLOOKUP()`
355+
356+
Fungsi `GET_XLOOKUP(lookup_value, lookup_vector, return_array, [if_not_found], [match_mode], [search_mode])` dapat digunakan sebagai pengganti fungsi `XLOOKUP()` bagi input berupa _vector_.
357+
358+
::::: {.border .p-3 .my-3 .justify}
359+
360+
::: {.text-center .syntax}
361+
362+
_Syntax_
363+
: GET_XLOOKUP(lookup_value, lookup_vector, return_array, [if_not_found], [match_mode], [search_mode])
364+
365+
_Output_
366+
: _array_
367+
368+
:::
369+
370+
---
371+
372+
`lookup_value := [vector]`
373+
: Nilai yang akan dicari. Menerima input berupa _vector_.
374+
375+
`lookup_array := [array]`
376+
: _Array_ atau rentang untuk dicari.
377+
378+
`return_array := [array]`
379+
: _Array_ atau rentang yang akan dikembalikan
380+
381+
`[if_not_found] := #N/A :: [text]`
382+
: Jika kecocokan valid tidak ditemukan, kembalikan teks `[if_not_found]` yang Anda masukkan. Jika kecocokan valid tidak ditemukan, dan `[if_not_found]` hilang, `#N/A` dikembalikan.
383+
384+
`[match_mode] := 0 :: [0 | -1 | 1 | 2]`
385+
: Tentukan tipe yang cocok:
386+
387+
> - `0` - Persis cocok. Jika tidak ditemukan, kembalikan `#N/A`. Ini adalah pengaturan **default**.
388+
> - `-1 ` - Persis cocok. Jika tidak ada yang ditemukan, kembalikan item berikutnya yang lebih kecil.
389+
> - `1` - Persis sama. Jika tidak ditemukan, kembalikan item berikutnya yang lebih besar.
390+
> - `2` - A wildcard match where *, ?, and ~ have special meaning.
391+
392+
`[search_mode] := 1 :: [1 | -1 | 2 | -2]`
393+
: Tentukan mode pencarian yang akan digunakan:
394+
395+
> - `1` - Melakukan pencarian dimulai dari item pertama. Ini adalah pengaturan default.
396+
> - `-1` - Melakukan pencarian terbalik dimulai dari item terakhir.
397+
> - `2` - Melakukan pencarian biner yang bergantung pada lookup_array diurutkan dalam urutan naik . Jika tidak diurutkan, hasil yang tidak valid akan dikembalikan.
398+
> - `-2` - Melakukan pencarian biner yang mengandalkan lookup_array diurutkan dalam urutan menurun . Jika tidak diurutkan, hasil yang tidak valid akan dikembalikan.
399+
400+
:::::
401+
402+
Penjelasan parameter diambil dari [halaman bantuan `XLOOKUP()`](https://support.microsoft.com/id-id/office/fungsi-xlookup-b7fd680e-6d10-43e6-84f9-88eae8bf5929)
403+
404+
::: {.column-page-left}
405+
![Demonstrasi `GET_XLOOKUP()`](img-0-4-0/feidlambda-GET-XLOOKUP-01.gif){#fig-get-xlookup}
406+
:::
407+
306408
::: {.column-screen-inset-shaded}
307409

308410
---
@@ -974,8 +1076,6 @@ Deskripsi `ignore_empty`, `match_mode`, dan `pad_with` diambil dari halaman [Fun
9741076

9751077
:::
9761078

977-
Fungsi feidlambda v0.4 memiliki $10$ kategori dengan total $23$ fungsi utama dan pendukung.
978-
9791079
Jika ada ide untuk pengembangan feidlambda atau fungsi baru bisa langsung disampaikan dengan membuat [isu di github](https://github.com/fiakoenjiniring/feidlambda/issues/new). Dan jika bertemu masalah saat penggunaan feidlambda v0.4, bisa juga membuat [isu di github](https://github.com/fiakoenjiniring/feidlambda/issues/new).
9801080

9811081
::: {.column-screen-inset-shaded}
@@ -986,6 +1086,6 @@ Jika ada ide untuk pengembangan feidlambda atau fungsi baru bisa langsung disamp
9861086

9871087
# Changelog
9881088

989-
- **2023-05-19 (v0.4.0)**
1089+
- **2023-05-26 (v0.4.0)**
9901090
- Rilis feidlambda v0.4
9911091

‎release/feidmath-0-1.qmd‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: |
44
subtitle: |
55
Koleksi LAMBDA feidmath v0.1
66
author: "Taruma Sakti Megariansyah"
7-
date: 2023-05-19
7+
date: 2023-05-26
88
# date-modified: 2023-04-19
99
date-format: full
1010
lang: id
@@ -39,6 +39,12 @@ aliases:
3939
```default
4040
https://gist.github.com/taruma/b4df638ecb7af48ab63691951481d6b2
4141
```
42+
:::
43+
44+
::: {.text-center}
45+
46+
[<button type="button" class="btn btn-info m-1">INSTALASI</button>](/docs/install.qmd)
47+
[<button type="button" class="btn btn-primary m-1">WORKSHEET FEIDMATH v0.1.0</button>](https://github.com/fiakoenjiniring/feidlambda/releases/download/v0.4.0/RELEASE_feidmath_v0_1_0.xlsx)
4248

4349
:::
4450

@@ -60,7 +66,7 @@ Mengikuti panduan [FIAKO LAMBDA Style Guide](/docs/lambda-style-guide.qmd) dan [
6066
- [NEW]{.f-new} `LINALG_*`: Ini mencakup fungsi-fungsi yang berkaitan dengan aljabar linear, seperti operasi pada vektor dan matriks
6167
- [NEW]{.f-new} `GEOMETRY_*`: Kategori ini melibatkan fungsi geometri, termasuk mengidentifikasi titik berada di dalam/luar poligon.
6268

63-
Download excel demonstrasi [RELEASE_feidmath_v0_4_0.xlsx](https://github.com/fiakoenjiniring/feidlambda/releases/download/v0.4.0/RELEASE_feidmath_v0_1_0.xlsx), untuk memudahkan mengeksplorasi fungsi baru di feidmath v0.1.x.
69+
Download excel demonstrasi [RELEASE_feidmath_v0_1_0.xlsx](https://github.com/fiakoenjiniring/feidlambda/releases/download/v0.4.0/RELEASE_feidmath_v0_1_0.xlsx), untuk memudahkan mengeksplorasi fungsi baru di feidmath v0.1.x.
6470

6571
::: {.column-screen-inset-shaded}
6672

‎release/img-0-4-0/feidlambda-APPLY-01.gif‎

496 KB
Loading

‎release/img-0-4-0/feidlambda-GET-XLOOKUP-01.gif‎

559 KB
Loading

0 commit comments

Comments
 (0)