brainscore-vision 2.1__py3-none-any.whl

brainscore_vision/data/david2004/data_packaging/lib/GetMD5/GetMD5.m

@@ -0,0 +1,107 @@
+function GetMD5
+% GetMD5 - 128 bit MD5 checksum: file, string, array, byte stream
+% This function calculates a 128 bit checksum for arrays or files.
+% Digest = GetMD5(Data, Mode, Format)
+% INPUT:
+%   Data:   File name or array.
+%   Mode:   String to declare the type of the 1st input. Not case-sensitive.
+%             'File':   Data is a file name as string.
+%             '8Bit':   If Data is a CHAR array, only the 8 bit ASCII part is
+%                       used. Then the digest is the same as for a ASCII text
+%                       file e.g. created by: FWRITE(FID, Data, 'uchar').
+%                       This is ignored if Data is not of type CHAR.
+%             'Binary': The MD5 sum is obtained for the contents of Data.
+%                       This works for numerical, CHAR and LOGICAL arrays.
+%             'Array':  Include the class and dimensions of Data in the MD5
+%                       sum. This can be applied for (nested) structs, cells
+%                       and sparse arrays also.
+%           Optional. Default: '8Bit' for CHAR, 'Binary' otherwise.
+%   Format: String, format of the output. Only the first character matters.
+%           The upper/lower case matters for 'hex' only.
+%             'hex':    [1 x 32] lowercase hexadecimal string.
+%             'HEX':    [1 x 32] uppercase hexadecimal string.
+%             'double': [1 x 16] double vector with UINT8 values.
+%             'uint8':  [1 x 16] uint8 vector.
+%             'base64': [1 x 22] string, encoded to base 64 (A:Z,a:z,0:9,+,/).
+%                       The string is not padded to keep it short.
+%           Optional, default: 'hex'.
+%
+% OUTPUT:
+%   Digest: A 128 bit number is replied in the specified format.
+%
+% NOTE:
+%   For sparse arrays, function handles, java and user-defined objects the
+%   M-file GetMD5_helper is called.
+%
+% EXAMPLES:
+% Three methods to get the MD5 of a file:
+%   1. Direct file access (recommended):
+%     MD5 = GetMD5(which('GetMD5.m'), 'File')
+%   2. Import the file to a CHAR array (no text mode for exact line breaks!):
+%     FID = fopen(which('GetMD5.m'), 'r');
+%     S   = fread(FID, inf, 'uchar=>char');
+%     fclose(FID);
+%     MD5 = GetMD5(S, '8bit')
+%   3. Import file as a byte stream:
+%     FID = fopen(which('GetMD5.m'), 'r');
+%     S   = fread(FID, inf, 'uint8=>uint8');
+%     fclose(FID);
+%     MD5 = GetMD5(S, 'bin');  % 'bin' can be omitted here
+%
+%   Test data:
+%     GetMD5(char(0:511), '8bit', 'HEX')
+%       % => F5C8E3C31C044BAE0E65569560B54332
+%     GetMD5(char(0:511), 'bin')
+%       % => 3484769D4F7EBB88BBE942BB924834CD
+%     GetMD5(char(0:511), 'array')
+%       % => b9a955ae730b25330d4f4ebb0a51e8f0
+%     GetMD5('abc')   % implicit '8bit' for CHAR string
+%       % => 900150983cd24fb0d6963f7d28e17f72
+%
+% COMPILATION:
+%   The C-Mex-file is compiled automatically, when this function is called the
+%   first time.
+%   See GetMD5.c for details or a manual compilation.
+%
+% Tested: Matlab/64 7.8, 7.13, 8.6, 9.1, Win7/64
+% Author: Jan Simon, Heidelberg, (C) 2009-2017 matlab.2010(a)n(MINUS)simon.de
+% License: This program is derived from the RSA Data Security, Inc.
+%          MD5 Message Digest Algorithm, RFC 1321, R. Rivest, April 1992
+%          This implementation is published under the BSD license.
+%
+% See also CalcCRC32, DataHash.
+%
+% For more checksum methods see:
+%   http://www.mathworks.com/matlabcentral/fileexchange/31272-datahash
+
+% $JRev: R5A V:032 Sum:Uc4I3TNDzn7/ Date:03-Jan-2017 13:59:12 $
+% $License: BSD (use/copy/change/redistribute on own risk, mention the author) $
+% $UnitTest: uTest_GetMD5 $
+% $File: Tools\GLFile\GetMD5.m $
+% History:
+% 015: 15-Dec-2009 16:53, BUGFIX: UINT32 has 32 bits on 64 bit systems now.
+%      Thanks to Sebastiaan Breedveld!
+% 026: 30-Jan-2015 00:12, 64 bit arrays larger than 2.1GB accepted.
+%      Successor of "CalcMD5".
+% 031: 04-Jun-2016 22:26, Structs and cells are handled.
+
+% Dummy code, which calls the auto-compilation only: ---------------------------
+persistent FirstRun
+if isempty(FirstRun)
+   ok = InstallMex('GetMD5.c', 'uTest_GetMD5');
+   if ok
+      FirstRun = false;
+   end
+
+   try
+      dummy = GetMD5_helper([]);  %#ok<NASGU>
+   catch ME
+      error(['JSimon:', mfilename, ':NoHelper'], ...
+         '### %s: GetMD5_Helper.m: %s', mfilename, ME.message);
+   end
+else
+   error(['JSimon:', mfilename, ':MissMEX'], ...
+      'Cannot find Mex file: %s', [mfilename, '.', mexext]);
+end
+
+% return;

brainscore_vision/data/david2004/data_packaging/lib/GetMD5/GetMD5_helper.m

@@ -0,0 +1,91 @@
+function S = GetMD5_helper(V)
+% GetMD5_helper: Convert non-elementary array types for GetMD5
+% The C-Mex function GetMD5 calls this function to obtain meaningful unique data
+% for function handles, java or user-defined objects and sparse arrays. The
+% applied processing can depend on the needs of the users, therefore it is
+% implemented as an M-function, which is easier to modify than the C-code.
+%
+% INPUT:
+%   V: Array of any type, which is not handled in the C-Mex.
+% OUTPUT:
+%   S: Array or struct containing elementary types only.
+%      The implementation migth be changed by the user!
+%      Default:
+%      - Sparse arrays:   Struct containing the indices and values.
+%      - Function handle: The reply of FUNCTIONS and the size and date of the
+%        file.
+%      - User defined and java objects: V.hashCode if existing, else: struct(V).
+%
+% NOTE:
+%   For objects the function getByteStreamFromArray() might be exhaustive and
+%   efficient, but unfortunately it is not documented.
+%
+% Tested: Matlab/64 7.8, 7.13, 8.6, 9.1, Win7/64
+% Author: Jan Simon, Heidelberg, (C) 2016-2017 matlab.2010(a)n(MINUS)simon.de
+
+% $JRev: R5i V:008 Sum:hPPK4pV7BpW8 Date:03-Jan-2017 13:59:12 $
+% $License: BSD (use/copy/change/redistribute on own risk, mention the author) $
+% $File: Tools\GLFile\GetMD5_helper.m $
+% History:
+% 001: 28-Jun-2015 19:19, Helper for GetMD5.
+
+% Initialize: ==================================================================
+% Do the work: =================================================================
+
+% The dimensions, number of dimensions and the name of the class is considered
+% already in the MEX function!
+
+if isa(V, 'function_handle')
+   % Please adjust the subfunction ConvertFuncHandles to your needs.
+   
+   % The Matlab version influences the conversion by FUNCTIONS:
+   % 1. The format of the struct replied FUNCTIONS is not fixed,
+   % 2. The full path of toolbox function e.g. for @mean differ.
+   S = functions(V);
+   
+   % Include modification file time and file size. Suggested by Aslak Grinsted:
+   if ~isempty(S.file)
+      d = dir(S.file);
+      if ~isempty(d)
+         S.filebytes = d.bytes;
+         S.filedate  = d.datenum;
+      end
+   end
+   
+   % ALTERNATIVE: Use name and path. The <matlabroot> part of the toolbox
+   % functions is replaced such that the hash for @mean does not depend on the
+   % Matlab version.
+   % Drawbacks: Anonymous functions, nested functions...
+   % funcStruct = functions(FuncH);
+   % funcfile   = strrep(funcStruct.file, matlabroot, '<MATLAB>');
+   % S          = uint8([funcStruct.function, ' ', funcfile]);
+   
+   % Finally I'm afraid there is no unique method to get a hash for a function
+   % handle. Please adjust this conversion to your needs.
+   
+elseif (isobject(V) || isjava(V)) && ismethod(V, 'hashCode')  % ================
+   % Java or user-defined objects might have a hash function:
+   S = char(V.hashCode);
+   
+elseif issparse(V)  % ==========================================================
+   % Create struct with indices and non-zero values:
+   [S.Index1, S.Index2, S.Value] = find(V);
+   
+else  % Most likely this is a user-defined object: =============================
+   try    % Perhaps a direct conversion is implemented:
+      S = uint8(V);
+      
+      % Matt Raum had this excellent idea - unfortunately this function is
+      % undocumented and might not be supported in te future:
+      % S = getByteStreamFromArray(DataObj);
+
+   catch ME  % Or perhaps this is better:
+      fprintf(2, ['### %s: Convert object to struct as fallback.', char(10), ...
+         '    %s\n'], ME.message);
+      WarnS = warning('off', 'MATLAB:structOnObject');
+      S     = struct(V);
+      warning(WarnS);
+   end
+end
+
+% return;

brainscore_vision/data/david2004/data_packaging/lib/GetMD5/InstallMex.m

@@ -0,0 +1,307 @@
+function Ok = InstallMex(SourceFile, varargin)
+% INSTALLMEX - Compile and install Mex file
+% The C, C++ or FORTRAN mex file is compiled and additional installation
+% routines are started. Advanced users can call MEX() manually instead, but some
+% beginners are overwhelmed by instructions for a compilation sometimes.
+% Therefore this function can be called automatically from an M-function, when
+% the compiled Mex-Function does not exist already.
+%
+% Ok = InstallMex(SourceFile, ...)
+% INPUT:
+%   SourceFile: Name of the source file, with or without absolute or partial
+%               path. The default extension '.c' is appended on demand.
+%   Optional arguments in arbitrary order:
+%     Function name: Function is started after compiling, e.g. a unit-test.
+%     Cell string:   Additional arguments for the compilation, e.g. libraries.
+%     '-debug':      Enable debug mode.
+%     '-force32':    Use the compatibleArrayDims flag under 64 bit Matlab.
+%     '-replace':    Overwrite existing mex file without confirmation.
+%
+% OUTPUT:
+%   Ok:  Logical flag, TRUE if compilation was successful. Optional.
+%
+% COMPATIBILITY:
+% - A compiler must be installed and setup before: mex -setup
+% - For Linux and MacOS the C99 style is enabled for C-files.
+% - The optimization flag -O is set.
+% - Defined compiler directives:
+%    * MATLABVER<XYZ>: <XYZ> is the current version, e.g. 708 for v7.8.
+%    * _LITTLE_ENDIAN or _BIG_ENDIAN: according to processor type
+%    * HAS_HG2: Defined for Matlab >= R2014b with HG2 graphics.
+%
+% EXAMPLES:
+% Compile func1.c with LAPACK libraries:
+%   InstallMex('func1', {'libmwlapack.lib', 'libmwblas.lib'})
+% Compile func2.cpp, enable debugging and call a test function:
+%   InstallMex('func2.cpp', '-debug', 'Test_func2');
+% These commands can be appended after the help section of an M-file, when the
+% compilation should be started automatically, if the compiled MEX is not found.
+%
+% NOTES:
+% Suggestions for improvements and comments are welcome!
+% Feel free to add this function to your FEX submissions, when you change the
+% URL in the variable "Precompiled" accordingly.
+%
+% Tested: Matlab/64 7.8, 7.13, 8.6, 9.1, Win7/64
+% Author: Jan Simon, Heidelberg, (C) 2012-2017 matlab.2010(a)n(MINUS)simon.de
+
+% $JRev: R5J V:035 Sum:2nORyg1Xr1iA Date:03-Jan-2017 15:58:22 $
+% $License: BSD (use/copy/change/redistribute on own risk, mention the author) $
+% $File: Tools\GLSource\InstallMex.m $
+% History:
+% 001: 27-Jul-2012 09:06, First version.
+% 005: 29-Jul-2012 17:11, Run the unit-test instead of showing a link only.
+% 006: 11-Aug-2012 23:59, Inputs are accepted in free order.
+% 020: 30-Dec-2013 01:48, Show a question dialog if mex is existing already.
+% 027: 08-Mar-2015 22:15, Define _LITTLE_ENDIAN / _BIG_ENDIAN.
+% 028: 22-Aug-2015 19:16, Define HAS_HG2 for Matlab >= 2014b.
+% 029: 24-Dec-2015 17:46, CATCH MException: No Matlab6.5 support anymore.
+% 032: 24-Apr-2016 17:45, Bugs fixed: "cmd" instead of "cmdStr".
+
+% Initialize: ==================================================================
+% Global Interface: ------------------------------------------------------------
+% URL to file or folder containing pre-compiled files, or the empty string if
+% pre-compiled files are not offered:
+% ### START: ADJUST TO USER NEEDS
+Precompiled = 'http://www.n-simon.de/mex';
+% ### END
+
+% Initial values: --------------------------------------------------------------
+bakCD   = cd;
+matlabV = [100, 1] * sscanf(version, '%d.%d', 2);  % Matlab version
+[Arch, MaxSize, Endian] = computer;  %#ok<ASGLU>
+
+hasHG2         = (matlabV >= 804);  % R2014b
+hasLargeDims   = (matlabV >= 705) & any(strfind(Arch, '64'));  % R2007b & 64bit
+isLittleEndian = strncmpi(Endian, 'L', 1);
+
+% Program Interface: -----------------------------------------------------------
+% Parse inputs:
+Param       = {};
+UnitTestFcn = '';
+doDebug     = false;
+debugFlag   = {};
+force32     = false;
+replace     = false;
+
+% First input is the name of the source file:
+if ~ischar(SourceFile)
+   error_L('BadTypeInput1', '1st input must be a string.');
+end
+
+% Additional inputs are identified by their type:
+% String:      unit-test function or the flag to enable debugging.
+% Cell string: additional parameters for the MEX command
+for iArg = 1:numel(varargin)
+   Arg = varargin{iArg};
+   if ischar(Arg)
+      if strcmpi(Arg, '-debug')
+         doDebug     = true;
+         debugFlag   = {'-v'};
+      elseif strcmpi(Arg, '-force32')
+         force32     = true;
+      elseif strcmpi(Arg, '-replace')
+         replace     = true;
+      elseif exist(Arg, 'file') == 2
+         UnitTestFcn = Arg;
+      else
+         error_L('MissFile', 'Unknown string or missing file: %s', Arg);
+      end
+   elseif iscellstr(Arg)  % As row cell:
+      Param = Arg(:).';
+   else
+      error_L('BadInputType', 'Bad type of input.');
+   end
+end
+
+% User Interface: --------------------------------------------------------------
+hasHRef = usejava('jvm');   % Hyper-links in the command window?
+
+% Do the work: =================================================================
+% Search the source file, solve partial or relative path, get the real
+% upper/lower case:
+[dummy, dummy, Ext] = fileparts(SourceFile);  %#ok<ASGLU>
+if isempty(Ext)
+   SourceFile = [SourceFile, '.c'];
+end
+
+whichSource = which(SourceFile);
+if isempty(whichSource)
+   error_L('NoSource', 'Cannot find the source file: %s', SourceFile);
+end
+[SourcePath, SourceName, Ext] = fileparts(whichSource);
+Source                        = [SourceName, Ext];
+
+% Consider output name and outputdir:
+index = find(strcmpi(Param, '-output'), 1, 'last');
+if isempty(index)
+   mexName = SourceName;
+else
+   [dummy, mexName] = fileparts(Param{index + 1});  %#ok<ASGLU>
+end
+mexFile = [mexName, '.', mexext];
+
+index = find(strcmpi(Param, '-outdir'), 1, 'last');
+if isempty(index)
+   mexPath = SourcePath;
+else
+   mexPath = Param{index + 1};
+end
+
+fprintf('== Compile: %s\n', fullfile(SourcePath, Source));
+
+% Check if the compiled file is existing already:
+whichMex = which(mexFile);
+if ~isempty(whichMex)
+   fprintf('  Existing already:  %s\n', whichMex);
+   
+   if ~replace
+      % Ask the user if a new compilation is wanted:
+      QuestReply = questdlg({ ...
+         ['\bf', mfilename, ': ', TeXFirm(SourceName), '\rm'], ...
+         '', 'The function is existing already:', ...
+         ['  ', TeXFirm(whichMex)], '', ...
+         'Do you want to compile it here:', ...
+         ['  ', TeXFirm(fullfile(mexPath, mexFile))], ''}, ...
+         mfilename, 'Compile', 'Cancel', ...
+         struct('Default', 'Cancel', 'Interpreter', 'tex'));
+      
+      % User does not want to recompile:
+      if strcmp(QuestReply, 'Cancel')
+         if nargout
+            Ok = false;
+         end
+         return;
+      end
+   end
+   fprintf('  Recompile in: %s\n\n', mexPath);
+end
+
+if ~ispc && strcmpi(Ext, '.c')
+   % C99 for the GCC and XCode compilers.
+   % Note: 'CFLAGS="\$CFLAGS -std=c99"' must be separated to 2 strings!!!
+   Flags = {'-O', 'CFLAGS="\$CFLAGS', '-std=c99"'};
+else
+   Flags = {'-O'};
+end
+
+% Large array dimensions under 64 bit, possible since R2007b:
+matlabVDef = {sprintf('-DMATLABVER=%d', matlabV)};
+if hasLargeDims && ~force32
+   Flags = cat(2, Flags, {'-largeArrayDims'});
+else
+   Flags = cat(2, Flags, {'-compatibleArrayDims'});
+end
+
+% Define endianess directive:
+if isLittleEndian
+   Flags = cat(2, Flags, {'-D_LITTLE_ENDIAN'});
+else  % Does Matlab run on a big endian machine currently?!
+   Flags = cat(2, Flags, {'-D_BIG_ENDIAN'});
+end
+
+% Define the new HG2 graphic handles:
+if hasHG2
+   Flags = cat(2, Flags, {'-DHAS_HG2'});
+end
+
+% Compile: ---------------------------------------------------------------------
+% Display the compilation command:
+Flags  = cat(1, Flags(:), debugFlag, matlabVDef, Param(:), {Source});
+cmdStr = ['mex', sprintf(' %s', Flags{:})];
+fprintf('%s\n\n', cmdStr);
+
+cd(SourcePath);
+try    % Start the compilation:
+   mex(Flags{:});
+   compiled = true;
+   fprintf('Compiled:\n  %s\n', which(mexFile));
+   
+catch ME  % Compilation failed - MException fails in Matlab 6.5!
+   compiled = false;
+   fprintf(2, '\n*** Compilation failed:\n%s\n\n', ME.message);
+   fprintf('Matlab version: %s\n', version);
+   if ~doDebug  % Compile again in debug mode if not done already:
+      fprintf('Compile with debug flag to get details:\n');
+      try
+         mex(Flags{:}, '-v');
+      catch  % Empty - it is known already that it fails
+      end
+   end
+   
+   % Show commands for manual compilation and download pre-compiled files:
+   fprintf('\n== The compilation failed! Possible solutions:\n');
+   fprintf('  * Is a compiler installed and set up properly by: mex -setup?\n');
+   fprintf('  * Try to compile manually:\n    cd(''%s'')\n', SourcePath);
+   fprintf('    %s -v\n', cmdStr);
+   fprintf('  * Or download the pre-compiled file %s:\n', mexFile);
+   if ~isempty(Precompiled)
+      if hasHRef
+         fprintf( ...
+            '    <a href="matlab:web(''%s#%s'',''-browser'')">%s</a>\n', ...
+            Precompiled, mexFile, Precompiled);
+      else  % No hyper-references in the command window without Java:
+         fprintf('    %s\n', Precompiled);
+      end
+   end
+   fprintf('  * Please send this report to the author.\n');
+end
+
+% Restore original directory and check precedence: -----------------------------
+cd(bakCD);
+if compiled
+   allWhich = which(mexName, '-all');
+   if ~strcmpi(allWhich{1}, fullfile(mexPath, mexFile))
+      Spec  = sprintf('  %%-%ds   ', max(cellfun('length', allWhich)));
+      fprintf(2, '\n*** Failed: Compiled function is shadowed:\n');
+      fprintf(2, [Spec, '*USED*\n'],     allWhich{1});
+      fprintf(2, [Spec, '*SHADOWED*\n'], allWhich{2:end});
+      
+      compiled = false;
+   end
+   
+   allWhichMex = which(mexFile, '-all');
+   if length(allWhichMex) > 1
+      fprintf(2, '\n::: Multiple instances of compiled file:\n');
+      fprintf(2, '  %s\n', allWhich{:});
+   end
+end
+
+% Run the unit-test: -----------------------------------------------------------
+if ~isempty(UnitTestFcn) && compiled
+   fprintf('\n\n== Post processing:\n');
+   [dum, UnitTestName] = fileparts(UnitTestFcn);  %#ok<ASGLU> % Remove extension
+   if ~isempty(which(UnitTestName))
+      fprintf('  Call: %s\n\n', UnitTestName);
+      feval(UnitTestName);
+   else
+      fprintf(2, '??? Cannot find function: %s\n', UnitTestFcn);
+   end
+end
+
+% Return success of compilation: -----------------------------------------------
+if nargout >= 1
+   Ok = compiled;
+end
+if compiled
+   fprintf('\n== %s: ready.\n', mfilename);
+else
+   fprintf('\n== %s: failed.\n', mfilename);
+end
+
+% end
+
+% ******************************************************************************
+function error_L(ID, Msg, varargin)
+% Automatic error ID and mfilename in the message:
+error(['JSimon:', mfilename, ':', ID], ...
+   ['*** %s: ', Msg], mfilename, varargin{:});
+
+% end
+
+% ******************************************************************************
+function S = TeXFirm(S)
+% Escape special characters for the TeX interpreter:
+S = strrep(strrep(S, '\', '\\'), '_', '\_');
+
+% end

brainscore_vision/data/david2004/data_packaging/lib/GetMD5/license.txt

@@ -0,0 +1,24 @@
+Copyright (c) 2017, Jan Simon
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in
+      the documentation and/or other materials provided with the distribution
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.