Module Bigarray.Array2
Contents
Instructions: Use this module in your project
In the IDE (CLion, Visual Studio Code, Xcode, etc.) you use for your DkSDK project:
Add the following to your project's
dependencies/CMakeLists.txt
:DkSDKProject_DeclareAvailable(ocaml CONSTRAINT "= 4.14.0" FINDLIBS str unix runtime_events threads dynlink) DkSDKProject_MakeAvailable(ocaml)
Add the
Findlib::ocaml
library to any desired targets insrc/*/CMakeLists.txt
:target_link_libraries(YourPackage_YourLibraryName # ... existing libraries, if any ... Findlib::ocaml)
Click your IDE's
Build
button
Not using DkSDK?
FIRST, do one or all of the following:
Run:
opam install ocaml.4.14.0
Edit your
dune-project
and add:(package (name YourExistingPackage) (depends ; ... existing dependenices ... (ocaml (>= 4.14.0))))
Then run:
dune build *.opam # if this fails, run: dune build
Edit your
<package>.opam
file and add:depends: [ # ... existing dependencies ... "ocaml" {>= "4.14.0"} ]
Then run:
opam install . --deps-only
FINALLY, add the library to any desired
(library)
and/or (executable)
targets in your **/dune
files:
(library
(name YourLibrary)
; ... existing library options ...
(libraries
; ... existing libraries ...
))
(executable
(name YourExecutable)
; ... existing executable options ...
(libraries
; ... existing libraries ...
))
type
``(!'a, !'b, !'c) t
The type of two-dimensional Bigarrays whose elements have OCaml type
'a
, representation kind 'b
, and memory layout 'c
.
Array2.create kind layout dim1 dim2
returns a new Bigarray of two
dimensions, whose size is dim1
in the first dimension and dim2
in
the second dimension. kind
and layout
determine the array element
kind and the array layout as described for
Bigarray.Genarray.create
.
val
init : ``(
'a
,
'b
)``
kind
->
'c
layout
->
``int
->
``int
->
``(``int
->
``int
->
'a
)``
->
``(
'a
,
'b
,
'c
)``
t
Array2.init kind layout dim1 dim2 f
returns a new Bigarray b
of two
dimensions, whose size is dim2
in the first dimension and dim2
in
the second dimension. kind
and layout
determine the array element
kind and the array layout as described for
Bigarray.Genarray.create
.
Each element Array2.get b i j
of the array is initialized to the
result of f i j
.
In other words, Array2.init kind layout dim1 dim2 f
tabulates the
results of f
applied to the indices of a new Bigarray whose layout is
described by kind
, layout
, dim1
and dim2
.
- since 4.12.0
val
dim1 : ``(
'a
,
'b
,
'c
)``
t
->
int
Return the first dimension of the given two-dimensional Bigarray.
val
dim2 : ``(
'a
,
'b
,
'c
)``
t
->
int
Return the second dimension of the given two-dimensional Bigarray.
Array2.change_layout a layout
returns a Bigarray with the specified
layout
, sharing the data with a
(and hence having the same
dimensions as a
). No copying of elements is involved: the new array
and the original array share the same storage space. The dimensions are
reversed, such that get v [| a; b |]
in C layout becomes
get v [| b+1; a+1 |]
in Fortran layout.
- since 4.06.0
val
size_in_bytes : ``(
'a
,
'b
,
'c
)``
t
->
int
size_in_bytes a
is the number of elements in a
multiplied by a
's
kind_size_in_bytes
.
- since 4.03.0
val
get : ``(
'a
,
'b
,
'c
)``
t
->
``int
->
``int
->
'a
Array2.get a x y
, also written a.{x,y}
, returns the element of a
at coordinates (x
, y
). x
and y
must be within the bounds of a
,
as described for
Bigarray.Genarray.get
;
otherwise, Invalid_argument
is raised.
val
set : ``(
'a
,
'b
,
'c
)``
t
->
``int
->
``int
->
'a
->
unit
Array2.set a x y v
, or alternatively a.{x,y} <- v
, stores the value
v
at coordinates (x
, y
) in a
. x
and y
must be within the
bounds of a
, as described for
Bigarray.Genarray.set
;
otherwise, Invalid_argument
is raised.
Extract a two-dimensional sub-array of the given two-dimensional
Bigarray by restricting the first dimension. See
Bigarray.Genarray.sub_left
for more details. Array2.sub_left
applies only to arrays with C
layout.
val
sub_right : ``(
'a
,
'b
,
fortran_layout
)``
t
->
``int
->
``int
->
``(
'a
,
'b
,
fortran_layout
)``
t
Extract a two-dimensional sub-array of the given two-dimensional
Bigarray by restricting the second dimension. See
Bigarray.Genarray.sub_right
for more details. Array2.sub_right
applies only to arrays with Fortran
layout.
Extract a row (one-dimensional slice) of the given two-dimensional
Bigarray. The integer parameter is the index of the row to extract. See
Bigarray.Genarray.slice_left
for more details. Array2.slice_left
applies only to arrays with C
layout.
val
slice_right : ``(
'a
,
'b
,
fortran_layout
)``
t
->
``int
->
``(
'a
,
'b
,
fortran_layout
)``
Array1.t
Extract a column (one-dimensional slice) of the given two-dimensional
Bigarray. The integer parameter is the index of the column to extract.
See
Bigarray.Genarray.slice_right
for more details. Array2.slice_right
applies only to arrays with
Fortran layout.
Copy the first Bigarray to the second Bigarray. See
Bigarray.Genarray.blit
for
more details.
val
fill : ``(
'a
,
'b
,
'c
)``
t
->
'a
->
unit
Fill the given Bigarray with the given value. See
Bigarray.Genarray.fill
for
more details.
Build a two-dimensional Bigarray initialized from the given array of arrays.
val
unsafe_get : ``(
'a
,
'b
,
'c
)``
t
->
``int
->
``int
->
'a
Like Bigarray.Array2.get
, but bounds checking is not
always performed.
val
unsafe_set : ``(
'a
,
'b
,
'c
)``
t
->
``int
->
``int
->
'a
->
unit
Like Bigarray.Array2.set
, but bounds checking is not
always performed.