PsychoPy - Psychology software for Python, Release 1.84.0
getPsychopyVersion()
Returns the version ofPsychoPy that was used to create this calibration
getSizePix()
Returns the size of the current calibration in pixels,or None ifnot defined
getSpectra()
Gets the wavelength values from the last spectrometer measurement (if available)
usage:
• nm,power =monitor.getSpectra()
getUseBits()
Was this calibration carried out witha a bits++ box
getWidth()
Of the viewable screen in cm, orNone if not known
lineariseLums(desiredLums, newInterpolators=False, overrideGamma=None)
lums should be uncalibrated luminance values (e.g. a linearramp)ranging 0:1
newCalib(calibName=None,
width=None,
distance=None,
gamma=None,
notes=None,
useBits=False,verbose=True)
create a new (empty) calibration for this monitor and makes this the current calibration
saveMon()
Saves the current dictionary ofcalibrations to disk
setCalibDate(date=None)
Sets the current calibration to have a date/time or to the current date/time if none given. (Also returns the
date as set)
setCurrent(calibration=-1)
Sets the current calibration for this monitor. Note that a single file can hold multiple calibrations each
stored under a different key (the date it was taken)
The argument is eithera string (naming the calib) oran integer eg:
myMon.setCurrent(’mainCalib’) fetches the calibration named mainCalib. You can
name calibrations what you want but PsychoPy will give themnames of date/time by default. In
Monitor Center you can ‘copy...’ a calibration and give it a new name to keep a second version.
calibName = myMon.setCurrent(0) fetches the first calibration (alphabetically) for
this monitor
calibName = myMon.setCurrent(-1) fetches the last alphabetical calibration for this
monitor (this is default). If default names are used for calibrations (ie date/time stamp) then this
will import the most recent.
setDKL_RGB(dkl_rgb)
Sets the DKL->RGB conversionmatrix fora chromatically calibratedmonitor(matrixis a 3x3numarray).
setDistance(distance)
To the screen (cm)
setGamma(gamma)
Sets the gamma value(s)for the monitor. This only uses a single gamma value for the three guns,which is
fairly approximate. Better to use setGammaGrid (which uses one gamma value for each gun)
setGammaGrid(gammaGrid)
Sets the min,max,gamma values for the each gun
8.14. psychopy.monitors - for those that don’t like Monitor Center
215
Pdf searchable text converter - search text inside PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Learn how to search text in PDF document and obtain text content and location information
find text in pdf image; search pdf documents for text
Pdf searchable text converter - VB.NET PDF Text Search Library: search text inside PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Learn How to Search Text in PDF Document and Obtain Text Content and Location Information in VB.NET application
search multiple pdf files for text; search a pdf file for text
PsychoPy - Psychology software for Python, Release 1.84.0
setLMS_RGB(lms_rgb)
Sets the LMS->RGB conversionmatrix fora chromatically calibratedmonitor(matrixis a 3x3numarray).
setLevelsPost(levels)
Sets the last set of luminance values measuredAFTER calibration
setLevelsPre(levels)
Sets the last set of luminance values measuredduring calibration
setLineariseMethod(method)
Sets the method for linearising 0 uses y=a+(bx)^gamma 1 uses y=(a+bx)^gamma 2 uses linear interpola-
tion over the curve
setLumsPost(lums)
Sets the last set of luminance values measuredAFTER calibration
setLumsPre(lums)
Sets the last set of luminance values measuredduring calibration
setMeanLum(meanLum)
Records the mean luminance (for reference only)
setNotes(notes)
For you to store notes about the calibration
setPsychopyVersion(version)
To store the version of PsychoPythat this calibration used
setSizePix(pixels)
Set the size of the screen in pixels x,y
setSpectra(nm, rgb)
Sets the phosphor spectra measured by the spectrometer
setUseBits(usebits)
DEPRECATED: Use the new hardware classes to control these devices
setWidth(width)
Of the viewable screen (cm)
8.14.2 GammaCalculator
class psychopy.monitors.GammaCalculator(inputs=(), lums=(), gamma=None, bitsIN=8, bit-
sOUT=8, eq=1)
Class for managing gamma tables
Parameters:
•inputs (required)= values at which you measuredscreenluminance either in range 0.0:1.0, or range
0:255. Should include the min and max of the monitor
Then give EITHER “lums” or“gamma”:
•lums =measured luminance at given input levels
•gamma = yourown gamma value (single float)
•bitsIN = number of values in yourlookup table
•bitsOUT = number ofbits in the DACs
myTable.gammaModel myTable.gamma
216
Chapter 8. Reference Manual (API)
C# PDF Convert to Text SDK: Convert PDF to txt files in C#.net
document to editable & searchable text file. Different from other C# .NET PDF to text conversion controls, RasterEdge C# PDF to text converter control toolkit
can't select text in pdf file; how to select text in pdf image
Online Convert PDF to Text file. Best free online PDF txt
document to editable & searchable text file. Different from other C# .NET PDF to text conversion controls, RasterEdge C# PDF to text converter control toolkit
search pdf files for text programmatically; pdf select text
PsychoPy - Psychology software for Python, Release 1.84.0
fitGammaErrFun(params, x, y, minLum,maxLum)
Provides an error function forfitting gamma function
(used by fitGammaFun)
fitGammaFun(x,y)
Fits a gamma function to the monitorcalibration data.
Parameters: -xVals are the monitor look-up-table vals, either 0-255 or 0.0-1.0 -yVals are the measured
luminances froma photometer/spectrometer
8.14.3 getAllMonitors()
psychopy.monitors.getAllMonitors()
Find the names of all monitors for which calibration files exist
8.14.4 findPR650()
psychopy.monitors.findPR650(ports=None)
DEPRECATED (as of v.1.60.01). Usepsychopy.hardware.findPhotometer() instead, which finds
awider range of devices
8.14.5 getLumSeriesPR650()
psychopy.monitors.getLumSeriesPR650(lumLevels=8, winSize=(800, 600), monitor=None,
gamma=1.0, allGuns=True, useBits=False, auto-
Mode=’auto’,stimSize=0.3, photometer=’COM1’)
DEPRECATED (since v1.60.01): Use psychopy.monitors.getLumSeries() instead
8.14.6 getRGBspectra()
psychopy.monitors.getRGBspectra(stimSize=0.3, winSize=(800,600),photometer=’COM1’)
usage: getRGBspectra(stimSize=0.3, winSize=(800,600), photometer=’COM1’)
Params
• ‘photometer’ could be a photometerobject ora serial port
name on which a photometer might be found (not recommended)
8.14.7 gammaFun()
psychopy.monitors.gammaFun(xx, minLum, maxLum,gamma, eq=1, a=None, b=None,k=None)
Returns gamma-transformed luminance values. y= gammaFun(x, minLum, maxLum, gamma)
aand b are calculated directly from minLum, maxLum, gamma
Parameters:
•xx are the input values (range 0-255 or 0.0-1.0)
•minLum = the minimum luminance of yourmonitor
8.14. psychopy.monitors - for those that don’t like Monitor Center
217
VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net
Text in any PDF fields can be copied and pasted to .txt files by keeping VB.NET control for batch converting PDF to editable & searchable text formats.
how to select text in pdf; how to make pdf text searchable
VB.NET Image: Robust OCR Recognition SDK for VB.NET, .NET Image
for VB.NET provides users fast and accurate image recognition function, which converts scanned images into searchable text formats, such as PDF, PDF/A, WORD
search text in multiple pdf; text searchable pdf file
PsychoPy - Psychology software for Python, Release 1.84.0
•maxLum = the maximum luminance of your monitor (forthis gun)
•gamma = the value ofgamma (for this gun)
8.14.8 gammaInvFun()
psychopy.monitors.gammaInvFun(yy, minLum, maxLum, gamma, b=None,eq=1)
Returns inverse gamma function for desired luminance values. x = gammaInvFun(y, minLum, maxLum,
gamma)
aand b are calculated directly from minLum, maxLum, gamma Parameters:
•xx are the input values (range 0-255 or 0.0-1.0)
•minLum = the minimum luminance of yourmonitor
•maxLum = the maximum luminance of your monitor (forthis gun)
•gamma = the value ofgamma (for this gun)
•eq determines the gammaequationused; eq==1[default]: yy = a + (b * xx)**gamma eq==2: yy = (a +
b*xx)**gamma
8.14.9 makeDKL2RGB()
psychopy.monitors.makeDKL2RGB(nm, powerRGB)
Creates a 3x3 DKL->RGB conversion matrix from the spectral input powers
8.14.10 makeLMS2RGB()
psychopy.monitors.makeLMS2RGB(nm, powerRGB)
Creates a 3x3 LMS->RGB conversion matrix from the spectral input powers
8.15 psychopy.parallel - functions for interacting with the parallel
port
This module provides read / write access to the parallel port for Linux orWindows.
The Parallel class describedbelowwill attempt toloadwhicheverparallel port driver is firstfoundon yoursystem
and should suffice in most instances. If you need to use a specific driver then, instead of usingParallelPort
shown below you can use one of the following as drop-in replacements, forcingthe use ofa specific driver:
• psychopy.parallel.PParallelInpOut32
• psychopy.parallel.PParallelDLPortIO
• psychopy.parallel.PParallelLinux
Either way, each instance ofthe class can provide access to a different parallel port.
There is also a legacy API which consists of the routines which are directly in this module. That API assumes you
only ever want to use a single parallel port at once.
218
Chapter 8. Reference Manual (API)
C# Create PDF Library SDK to convert PDF from other file formats
The PDF document file created by RasterEdge C# PDF document creator library is searchable and can be fully populated with editable text and graphics
pdf text select tool; cannot select text in pdf
C# PDF: C# Code to Draw Text and Graphics on PDF Document
Draw and write searchable text on PDF file by C# code in both Web and Windows applications. C#.NET PDF Document Drawing Application.
how to select text in pdf reader; convert pdf to searchable text online
PsychoPy - Psychology software for Python, Release 1.84.0
class psychopy.parallel.ParallelPort(address)
Class for read/write access to the parallel port on Windows &Linux
Usage:
from psychopy import parallel
port = parallel.ParallelPort(address=0x0378)
port.setData(4)
port.readPin(2)
port.setPin(21)
This is just a dummy constructor to avoid errors when the parallel port cannot be initiated
readData()
Return the value currentlyset on the data pins (2-9)
readPin(pinNumber)
Determine whether a desired (input)pin is high(1) or low(0).
Pins 2-13 and 15 are currently read here
setData(data)
Set the data to be presented on the parallel port (one ubyte). Alternatively you can set the value of each
pin (data pins are pins 2-9 inclusive)usingsetPin()
Examples:
parallel.setData(0)
# sets all pins low
parallel.setData(255)
# sets all pins high
parallel.setData(2)
# sets just pin 3 high (pin2 = bit0)
parallel.setData(3)
# sets just pins 2 and 3 high
You can also convert base 2 to int easily in python:
parallel.setData( int("00000011"2) )
# pins 2 and 3 high
parallel.setData( int("00000101"2) )
# pins 2 and 4 high
8.15.1 Legacy functions
We would stronglyrecommendyouuse the class above instead: these are providedfor backwards compatibility only.
parallel.setPortAddress(address=888)
Set the memory address or device node for your parallel port of your parallel port, to be used in subsequent
commands
Common port addresses:
LPT1 0x0378 or 0x03BC
LPT2 0x0278 or 0x0378
LPT3 0x0278
or for Linux:: /dev/parport0
This routine will attempt to find a usable driver depending on your platform
parallel.setData(data)
Set thedata to be presentedon the parallel port (one ubyte). Alternativelyyoucan setthe value ofeachpin(data
pins are pins 2-9 inclusive) usingsetPin()
Examples:
8.15. psychopy.parallel - functions for interacting with the parallel port
219
VB.NET Create PDF from Text to convert txt files to PDF in vb.net
Best VB.NET adobe text to PDF converter library for Visual Studio .NET project. Batch convert editable & searchable PDF document from TXT formats in VB.NET
pdf searchable text converter; how to select all text in pdf
C# Create PDF from Text to convert txt files to PDF in C#.net, ASP
PDF converter SDK for converting adobe PDF from TXT in Visual Studio .NET project. .NET control for batch converting text formats to editable & searchable PDF
text searchable pdf; how to search a pdf document for text
PsychoPy - Psychology software for Python, Release 1.84.0
parallel.setData(0)
# sets all pins low
parallel.setData(255)
# sets all pins high
parallel.setData(2)
# sets just pin 3 high (remember that pin2=bit0)
parallel.setData(3)
# sets just pins 2 and 3 high
You can also convert base 2 to int v easily in python:
parallel.setData(int("00000011"2))
# pins 2 and 3 high
parallel.setData(int("00000101"2))
# pins 2 and 4 high
parallel.setPin(pinNumber, state)
Set a desired pin to be high (1) orlow (0).
Only pins 2-9 (incl) are normally used for data output:
parallel.setPin(31)
# sets pin 3 high
parallel.setPin(30)
# sets pin 3 low
parallel.readPin(pinNumber)
Determine whether a desired (input) pin is high(1) orlow(0).
Pins 2-13 and 15 are currently read here
8.16 psychopy.preferences - getting and setting preferences
You can set preferences on a per-experiment basis. For example, if you would like to use a specificaudiolibrary, but
don’t want totouch your user settings in general, you can import preferences and set the optionaudioLib accordingly:
from psychopy import prefs
prefs.general['audioLib'= ['pyo']
from psychopy import sound
!!IMPORTANT!! You must import the sound module AFTER setting the preferences. To check that you are getting
what you want (don’t do this in youractual experiment):
print sound.Sound
The
output should
be
<class ’psychopy.sound.SoundPyo’>
for
pyo,
or
<class
’psychopy.sound.SoundPygame’> forpygame.
You canfindthe names of the preferences sections and their different optionshere.
8.16.1 Preferences
Class for loading / saving prefs
class psychopy.preferences.Preferences
Users can alter preferences from the dialog box in the application, by editing their user preferences file (which
is what the dialog box does) or, within a script, preferences can be controlled like this:
import psychopy
psychopy.prefs.general['audioLib'= ['pyo','pygame']
print(prefs)
# prints the location of the user prefs file and all the current vals
Use the instance of prefs, as above, rather than the Preferences class directly if you want to affect the script
that’s running.
220
Chapter 8. Reference Manual (API)
VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.
less searchable for search engines. The other is the crashing problem when user is visiting the PDF file using web browser. Our PDF to HTML converter library
text select tool pdf; find and replace text in pdf file
VB.NET Create PDF from Word Library to convert docx, doc to PDF in
Export all Word text and image content into high quality PDF without losing formatting. Easy to create searchable and scanned PDF files from Word.
find text in pdf files; how to select text in pdf and copy
PsychoPy - Psychology software for Python, Release 1.84.0
loadAll()
Load the user prefs and the application data
loadUserPrefs()
load userprefs, if any; don’t save to a file because doing so will break easy_install. Saving to files within
the psychopy/ is fine, eg for key-bindings, but outside it (where user prefs will live) is not allowed by
easy_install (security risk)
resetPrefs()
removes userPrefs.cfg, does not touch appData.cfg
restoreBadPrefs(cfg, result)
result = result ofvalidate
saveAppData()
Save the various setting to the appropriate files (or discard, insome cases)
saveUserPrefs()
Validate and save the various setting to the appropriate files (or discard, in some cases)
validate()
Validate (user) preferences and reset invalid settings to defaults
8.17 psychopy.serial - functions for interacting with the serial port
PsychoPy is compatible with Chris Liechti’spyserialpackage. You can use it like this:
import serial
ser = serial.Serial(019200, timeout=1)
# open first serial port
#ser = serial.Serial('/dev/ttyS1', 19200, timeout=1)#or something like this for Mac/Linux machines
ser.write('someCommand')
line = ser.readline()
# read a '\n' terminated line
ser.close()
Ports are fully configurable with all the options you would expect of RS232 communications.
See
http://pyserial.sourceforge.netforfurtherdetailsanddocumentation.
pyserial is packaged in the Standalone (Windows and Mac distributions), for manual installations you should install
this yourself.
8.18 psychopy.sound - play various forms of sound
8.18.1 Sound
PsychoPy currently supports a choice of two sound libraries: pyo, or pygame. Select which will be used via the
audioLibpreference. sound.Sound()willthenrefertoeitherSoundPyoorSoundPygame. Thiscanbesetonaper-
experiment basis by importing preferences, andsettingtheaudioLiboption to use.
It is important to use sound.Sound() in order for proper initialization of the relevant sound library. Do not use
sound.SoundPyo or sound.SoundPygame directly. Because they offer slightly different features, the differences be-
tween pyo and pygame sounds are describedhere. Pygame soundis more thoroughly tested, whereas pyooffers lower
latencyand more features.
8.17. psychopy.serial - functions for interacting with the serial port
221
PsychoPy - Psychology software for Python, Release 1.84.0
8.19 psychopy.tools - miscellaneous tools
Container for all miscellaneous functions and classes
8.19.1 psychopy.tools.colorspacetools
Functions and classes related to color space conversion
dkl2rgb(dkl[,conversionMatrix])
Convert from DKL color space (Derrington, Krauskopf& Lennie) to RGB.
dklCart2rgb(LUM,LM,S[,conversionMatrix]) Likedkl2rgbexceptthatitusescartesiancoords(LM,S,LUM)ratherthansphericalcoordsforDKL(elev,azim,contr).
rgb2dklCart(picture[,conversionMatrix])
Convert an RGB image into Cartesian DKL space.
hsv2rgb(hsv_Nx3)
Convert from HSVcolor space to RGB gunvalues.
lms2rgb(lms_Nx3[,conversionMatrix])
Convert from cone space (Long, Medium, Short) to RGB.
rgb2lms(rgb_Nx3[,conversionMatrix])
Convert from RGB to cone space (LMS).
dkl2rgb(dkl[,conversionMatrix])
Convert from DKL color space (Derrington, Krauskopf& Lennie) to RGB.
Function details
psychopy.tools.colorspacetools.dkl2rgb(dkl, conversionMatrix=None)
Convert from DKL color space (Derrington,Krauskopf& Lennie) to RGB.
Requires a conversion matrix, which will be generated from generic Sony Trinitron phosphors if not supplied
(note that this will not be an accurate representation of the colorspace unless you supply a conversion matrix).
usage:
rgb(Nx3) = dkl2rgb(dkl_Nx3(el,az,radius), conversionMatrix)
rgb(NxNx3) = dkl2rgb(dkl_NxNx3(el,az,radius), conversionMatrix)
psychopy.tools.colorspacetools.dklCart2rgb(LUM,LM,S, conversionMatrix=None)
Likedkl2rgb except that ituses cartesiancoords (LM,S,LUM)ratherthan spherical coords for DKL (elev, azim,
contr).
NB: this may return rgb values >1 or <-1
psychopy.tools.colorspacetools.rgb2dklCart(picture,conversionMatrix=None)
Convert an RGB image into Cartesian DKL space.
psychopy.tools.colorspacetools.hsv2rgb(hsv_Nx3)
Convert from HSV colorspace to RGB gun values.
usage:
rgb_Nx3 = hsv2rgb(hsv_Nx3)
Note that in some uses of HSV space the Hue component is given in radians or cycles (range 0:1]). In this
version H is given indegrees (0:360).
Also note that the RGB output ranges -1:1, in keeping with other PsychoPy functions.
psychopy.tools.colorspacetools.lms2rgb(lms_Nx3, conversionMatrix=None)
Convert from cone space (Long, Medium, Short)to RGB.
Requires a conversion matrix, which will be generated from generic Sony Trinitron phosphors if not supplied
(note that you will not get an accurate representation of the color space unless you supply a conversion matrix)
usage:
222
Chapter 8. Reference Manual (API)
PsychoPy - Psychology software for Python, Release 1.84.0
rgb_Nx3 = lms2rgb(dkl_Nx3(el,az,radius), conversionMatrix)
psychopy.tools.colorspacetools.rgb2lms(rgb_Nx3,conversionMatrix=None)
Convert from RGB to cone space (LMS).
Requires a conversion matrix, which will be generated from generic Sony Trinitron phosphors if not supplied
(note that you will not get an accurate representation of the color space unless you supply a conversion matrix)
usage:
lms_Nx3 = rgb2lms(rgb_Nx3(el,az,radius), conversionMatrix)
psychopy.tools.colorspacetools.dkl2rgb(dkl, conversionMatrix=None)
Convert from DKL color space (Derrington,Krauskopf& Lennie) to RGB.
Requires a conversion matrix, which will be generated from generic Sony Trinitron phosphors if not supplied
(note that this will not be an accurate representation of the colorspace unless you supply a conversion matrix).
usage:
rgb(Nx3) = dkl2rgb(dkl_Nx3(el,az,radius), conversionMatrix)
rgb(NxNx3) = dkl2rgb(dkl_NxNx3(el,az,radius), conversionMatrix)
8.19.2 psychopy.tools.coordinatetools
Functions and classes related to coordinate systemconversion
cart2pol(x,y[,units])
Convert fromcartesian topolar coordinates.
cart2sph(z,y,x)
Convert fromcartesian coordinates (x,y,z) to spherical (elevation, azimuth, radius).
pol2cart(theta,radius[,units]) Convertfrompolartocartesiancoordinates.
sph2cart(*args)
Convert fromspherical coordinates (elevation,azimuth, radius) to cartesian (x,y,z).
Function details
psychopy.tools.coordinatetools.cart2pol(x,y, units=’deg’)
Convert from cartesian to polar coordinates.
Usage theta,radius = pol2cart(x,y, units=’deg’)
units refers to the units (rad ordeg) for theta that should be returned
psychopy.tools.coordinatetools.cart2sph(z, y,x)
Convert from cartesian coordinates (x,y,z) to spherical (elevation, azimuth,radius). Output is in degrees.
usage: array3xN[el,az,rad]= cart2sph(array3xN[x,y,z])OR elevation, azimuth,radius = cart2sph(x,y,z)
If working in DKL space,z = Luminance, y = Sand x = LM
psychopy.tools.coordinatetools.pol2cart(theta, radius,units=’deg’)
Convert from polarto cartesian coordinates.
usage:
x,y = pol2cart(theta, radius, units='deg')
psychopy.tools.coordinatetools.sph2cart(*args)
Convert from spherical coordinates (elevation, azimuth, radius)to cartesian (x,y,z).
usage: array3xN[x,y,z]= sph2cart(array3xN[el,az,rad])OR x,y,z = sph2cart(elev,azim, radius)
8.19. psychopy.tools - miscellaneous tools
223
PsychoPy - Psychology software for Python, Release 1.84.0
8.19.3 psychopy.tools.filetools
Functions and classes related to file and directory handling
psychopy.tools.filetools.toFile(filename, data)
Save data (of any sort) as a pickle file.
simple wrapper of the cPickle module in core python
psychopy.tools.filetools.fromFile(filename)
Load data (of any sort) froma pickle file.
Simple wrapper ofthe cPickle module in core python
psychopy.tools.filetools.mergeFolder(src,dst,pattern=None)
Merge a folder into another.
Existing files in dst folder with the same name will be overwritten. Non-existent files/folders will be created.
psychopy.tools.filetools.openOutputFile(fileName, append=False, delim=None, fileColli-
sionMethod=’rename’, encoding=’utf-8’)
Open an output file (or standard output) forwriting.
Parameters
fileName [string]The desired output file name.
append [bool,optional]IfTrue,appenddata toanexisting file;otherwise,overwriteitwithnewdata. Defaults
to True, i.e. appending.
delim [string, optional] The delimiting character(s) between values. For a CSV file, this would be a comma.
For a TSV file,it would be ‘‘.
Defaults to ‘‘None.
fileCollisionMethod [string, optional] How to handle filename collisions. This is ignored if append is set to
True. Defaults to rename.
encoding [string, optional] The encoding touse when writing the file. This parameterwill be ignored ifappend
is False and fileName ends with .psydat or.npy(i.e. ifa binary file is to bewritten). Defaults to ’utf-8’.
Returns
f [file]A writable file handle.
Notes
If no known filename extension is given, and the delimiter is a comma, the extension .csv will be chosen
automatically. Ifthe extension is unknown and the delimiter is a tab, the extension will be .tsv. .txt will be
chosen otherwise.
psychopy.tools.filetools.genDelimiter(fileName)
Return a delimiter based on a filename.
Parameters
fileName [string]The output file name.
Returns
delim [string] A delimiter picked based on the supplied filename. This will be , if the filename extension is
.csv, and a tabulator character otherwise.
224
Chapter 8. Reference Manual (API)
Documents you may be interested
Documents you may be interested