PyKX under q Changelog

This changelog provides updates from PyKX 2.0.0 and above, for information relating to versions of PyKX prior to this version see the changelog linked below.

Note

The changelog presented here outlines changes to PyKX when operating within a q environment specifically, if you require changelogs associated with PyKX operating within a Python environment see here.

PyKX 2.3.1

Release Date

2024-02-07

Fixes and Improvements

.pykx.eval is now variadic allowing an optional second parameter to be passed to define return type. Previously would error with rank.
Behavior prior to changeBehavior post change
```
q).pykx.eval["lambda x: x";<] 7
'rank
[0]  .pykx.eval["lambda x: x";<] 7
```
```
q).pykx.eval["lambda x: x";<] 7
7
```

Wraps which have a return type assigned using < or > are now considered wraps and can be unwrapped:

Behavior prior to changeBehavior post change

q).pykx.util.isw .pykx.eval["lambda x: x"][<]
0b
q).pykx.unwrap  .pykx.eval["lambda x: x"][<]
{$[type[x]in 104 105 112h;util.foreignToq unwrap x;x]}.[code[foreign]]`.pykx.util.parseArgsenlist

q).pykx.util.isw .pykx.eval["lambda x: x"][<]
1b
q).pykx.unwrap  .pykx.eval["lambda x: x"][<]
foreign

.pykx.qcallable and .pykx.pycallable can now convert wraps which already have return types assigned:

Behavior prior to changeBehavior post change

q).pykx.qcallable[.pykx.eval["lambda x: x"][<]]`
'Could not convert provided function to callable with q return
q).pykx.print .pykx.pycallable[.pykx.eval["lambda x: x"][>]]
'Could not convert provided function to callable with Python return

q).pykx.qcallable[.pykx.eval["lambda x: x"][<]]`test
`test
q).pykx.print .pykx.wrap .pykx.pycallable[.pykx.eval["lambda x: x"][>]]`test
test

PyKX 2.3.0

Release Date

2024-01-22

Fixes and Improvements

A bug was fixed when using .pykx.console, it is now possible to access python variables set using the console with .pykx.(eval|pyexec|pyeval) functions.

Behavior prior to changeBehavior post change

q) .pykx.console[]
>>> a = 10
>>> quit()
q) .pykx.eval["a"]`
'NameError("name 'a' is not defined")
  [1]  /.../q/pykx.q:968: .pykx.eval:{wrap pyeval x}

q) .pykx.console[]
>>> a = 10
>>> quit()
q) .pykx.eval["a"]`
10

PyKX 2.2.2

Release Date

2023-12-07

Fixes and Improvements

When loaded in a q process loading pykx.q would not allow Ctrl+C (SIGINT) interruption.

PyKX 2.2.1

Release Date

2023-11-30

Fixes and Improvements

.pykx.print was using repr representation for some objects. Now consistently calls print.
.pykx.safeReimport now resets environment variables correctly before throwing any error raised by the function supplied to it.

Wrapped Python objects being supplied as arguments to functions were being converted according to .pykx.util.defaultConv. Now are left untouched:

Behavior prior to changeBehavior post change

q)\l pykx.q
q)np:.pykx.import `numpy;
q)r:np[`:random.rand;1;2];
q).pykx.print r
array([[0.03720163, 0.72012121]])
q).pykx.print .pykx.eval["lambda x: x"] r
array([array([0.03720163, 0.72012121])], dtype=object)
q).pykx.setdefault"py"
q).pykx.print .pykx.eval["lambda x: x"] r
[[0.037201634310417564, 0.7201212148535847]]

q).pykx.print r
array([[0.59110368, 0.52612429]])
q).pykx.print .pykx.eval["lambda x: x"] r
array([[0.59110368, 0.52612429]])
q).pykx.setdefault"py"
q).pykx.print .pykx.eval["lambda x: x"] r
array([[0.59110368, 0.52612429]])

q hsym will convert correctly to pathlib.PosixPath rather than str:

Behavior prior to changeBehavior post change

q).pykx.eval["lambda x: print(type(x))"] `:/path/to/somewhere;
<class 'str'>

q).pykx.eval["lambda x: print(type(x))"] `:/path/to/somewhere;
<class 'pathlib.PosixPath'>

PyKX 2.2.0

Release Date

2023-11-09

Additions

Addition of PYKX_EXECUTABLE environment/configuration variable to allow control of which Python executable is used under q.

Fixes and Improvements

Failure to access and load PyKX resulting in an os error now returns Python backtrace outlining the underlying Python error allowing for easier debugging

Behavior prior to changeBehavior post change

q)\l pykx.q
'os
  [4]  \python3 -c "import pykx; print(pykx.config.pykx_dir)" 2>/dev/null
       ^

q)\l pykx.q
Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "/usr/local/anaconda3/lib/python3.8/site-packages/pykx/__init__.py", line 27, in <module>
    from . import core
  File "pykx/core.pyx", line 6, in init pykx.core
    from .util import num_available_cores
  File "/usr/local/anaconda3/lib/python3.8/site-packages/pykx/util.py", line 8, in <module>
    import pandas as pd
  File "/usr/local/anaconda3/lib/python3.8/site-packages/pandas/__init__.py", line 16, in <module>
    raise ImportError(
ImportError: Unable to import required dependencies:
numpy: cannot import name 'SystemRandom' from 'random' (/Users/projects/pykx/src/pykx/random.py)
Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "/usr/local/anaconda3/lib/python3.8/site-packages/pykx/__init__.py", line 27, in <module>
    from . import core
  File "pykx/core.pyx", line 6, in init pykx.core
    from .util import num_available_cores
  File "/usr/local/anaconda3/lib/python3.8/site-packages/pykx/util.py", line 8, in <module>
    import pandas as pd
  File "/usr/local/anaconda3/lib/python3.8/site-packages/pandas/__init__.py", line 16, in <module>
    raise ImportError(
ImportError: Unable to import required dependencies:
numpy: cannot import name 'SystemRandom' from 'random' (/Users/projects/pykx/src/pykx/random.py)
'os
  [4]  \python3 -c "import pykx; print('PYKX_DIR: ' + str(pykx.config.pykx_dir))"

Fixed type error if converting dictionaries or keyed tables with conversion set to default
On load now sets PYKX_SKIP_UNDERQ rather than deprecated SKIP_UNDERQ
safeReimport now additionally unsets/resets: PYKX_DEFAULT_CONVERSION, PYKX_SKIP_UNDERQ, PYKX_EXECUTABLE, PYKX_DIR

PyKX 2.1.0

Release Date

2023-10-09

Fixes and Improvements

Update to default conversion logic for q objects passed to PyKX functions to more closely match embedPy based conversion expectations.For version <=2.0 conversions of KX lists would produce N Dimensional Numpy arrays of singular type. This results in issues when applying to many analytic libraries which rely on lists of lists rather than singular N Dimensional arrays. Additionally q tables and keyed tables would be converted to Numpy recarrays, these are now converted to Pandas DataFrames. To maintain previous behavior please set the following environment variable PYKX_DEFAULT_CONVERSION="np".
Behaviour prior to changeBehaviour post change
```
q).pykx.eval["lambda x:print(type(x))"](10?1f;10?1f)
<class 'numpy ndarray'>
q).pykx.eval["lambda x:print(type(x))"]([]10?1f;10?1f)
<class 'numpy.recarray'>
```
```
q).pykx.eval["lambda x:print(type(x))"](10?1f;10?1f)
<class 'list'>
q).pykx.eval["lambda x:print(type(x))"]([]10?1f;10?1f)
<class 'pandas.core.frame.DataFrame'>
```

PyKX 2.0.0

Release Date

2023-09-18

Additions

Addition of .pykx.qcallable and .pykx.pycallable functions which allow wrapping of a foreign Python callable function returning the result as q or Python foreign respectively.
Addition of .pykx.version allowing users to programmatically access their version from a q process.
Addition of .pykx.debug namespace containing copies of useful process initialization information specific to usage within a q environment
Addition of function .pykx.debugInfo which returns a string representation of useful information when debugging issues with the the use of PyKX within the q environment

Added the ability for users to print the return of a conversion object

q).pykx.print .pykx.topd ([]5?1f;5?1f)
          x        x1
0  0.613745  0.493183
1  0.529481  0.578520
2  0.691610  0.083889
3  0.229662  0.195991
4  0.691953  0.375638

Fixes and Improvements

Application of object setting on a Python list returns generic null rather than wrapped foreign object.
Use of environment variables relating to PyKX under q must use "true" as accepted value, previously any value set for such environment variables would be supported.
Fixed an issue where invocation of .pykx.print would not return results to stdout.
Fixed an issue where hsym/Path style objects could not be passed to Python functions
```
q).pykx.eval["lambda x: x"][`:test]`
`:test  
```
Resolution to memory leak incurred during invocation of .pykx.*eval functions relating to return of Python foreign objects to q.
Fixed an issue where segmentation faults could occur for various function if non Python backed foreign objects are passed in place of Python backed foreign
```
q).pykx.toq .pykx.util.load[(`foreign_to_q;1)]
'Provided foreign object is not a Python object
```
Fixed an issue where segmentation faults could occur through repeated invocation of .pykx.pyexec
```
q)do[1000;.pykx.pyexec"1+1"]
```
Removed the ability when using PyKX under q to allow users set reserved Python keywords to other values