LIB - Revision history

Kay: /* Existing implementations */ same

2026-03-17T12:56:57Z

Existing implementations: same

← Older revision		Revision as of 14:56, 17 March 2026
Line 688:		Line 688:

	# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors		# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors
	# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for M1 ~~Mac~~ is available - see [[Installation]]		# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for Apple Silicon (M1, M2, M3, M4 ...) Macs is available - see [[Installation]]
	# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file . A binary for Apple Silicon (M1, M2, M3, M4 ...) Macs is available - see [[Installation]].		# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file . A binary for Apple Silicon (M1, M2, M3, M4 ...) Macs is available - see [[Installation]].

Kay: /* Existing implementations */ explain M1 Mac better

2026-03-17T12:56:27Z

Existing implementations: explain M1 Mac better

← Older revision		Revision as of 14:56, 17 March 2026
Line 689:		Line 689:
	# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors		# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors
	# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for M1 Mac is available - see [[Installation]]		# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for M1 Mac is available - see [[Installation]]
	# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file . A binary for M1 ~~Mac~~ is available - see [[Installation]].		# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file . A binary for Apple Silicon (M1, M2, M3, M4 ...) Macs is available - see [[Installation]].

	Plugins for Linux and Intel-Mac can also be obtained through [https://www.globalphasing.com/autoproc/ GPhL's autoPROC].		Plugins for Linux and Intel-Mac can also be obtained through [https://www.globalphasing.com/autoproc/ GPhL's autoPROC].

Kay: /* Glue code / change XY*DEPTH to XYNBYTE

2024-05-29T21:22:42Z

Glue code: change X*Y*DEPTH to X*Y*NBYTE

← Older revision		Revision as of 23:22, 29 May 2024
Line 532:		Line 532:
	! 'NX' (integer) output Number of pixels along X		! 'NX' (integer) output Number of pixels along X
	! 'NY' (integer) output Number of pixels along Y		! 'NY' (integer) output Number of pixels along Y
	! 'NBYTE' (integer) output Number of bytes in the image~~...~~ XY~~DEPTH~~		! 'NBYTE' (integer) output Number of bytes in the image is XYNBYTE
	! 'QX' (4*REAL) output Pixel size		! 'QX' (4*REAL) output Pixel size
	! 'QY' (4*REAL) output Pixel size		! 'QY' (4*REAL) output Pixel size

Kay: /* Client code example */ hint to -static-libgfortran and -static-libquadmath (thanks Tim Grüne)

2024-05-29T21:15:26Z

Client code example: hint to -static-libgfortran and -static-libquadmath (thanks Tim Grüne)

← Older revision		Revision as of 23:15, 29 May 2024
Line 129:		Line 129:
	! or		! or
	! gfortran -fpic test_generic_client.f90 -shared -o libtest_generic_client.so		! gfortran -fpic test_generic_client.f90 -shared -o libtest_generic_client.so
	! (~~this does not include~~ the ~~compiler's~~ libgfortran.so and libquadmath.so ~~into~~ the ~~library~~; ~~don't know how to achieve this so~~		! (adding -static-libgfortran and -static-libquadmath should put these into the library as well so that it can be distributed.
	~~! gfortran is only useful if~~ it ~~is anyway installed on the machine~~)		! This requires a gfortran version higher than 12. For older gfortran versions, libgfortran.so and libquadmath.so can be
			! renamed to something that the linker does not search for; it will then include libgfortran.a and libquadmath.a)
	! The resulting file can be used with a LIB=./libtest_generic_client.so line in XDS.INP, and enables		! The resulting file can be used with a LIB=./libtest_generic_client.so line in XDS.INP, and enables
	! reading of data files with a 7680 bytes header plus 1024*1024 pixels of integer data, without any record structure.		! reading of data files with a 7680 bytes header plus 1024*1024 pixels of integer data, without any record structure.

Kay: link to documentation

2024-04-03T15:23:51Z

link to documentation

← Older revision		Revision as of 17:23, 3 April 2024
Line 1:		Line 1:
	The possibility of using external libraries (that are loaded at runtime) has been available in C/C++ for a long time, but in Fortran became only available as of Fortran2003.		The possibility of using external libraries (that are loaded at runtime) has been available in C/C++ for a long time, but in Fortran became only available as of Fortran2003.

	In the case of XDS, frame-reading and computation can be separated starting with version November-2016. ~~This~~ allows users/companies to develop their own specialized frame-reading libraries, and relieves the XDS maintainers from implementing even more file formats. The feature was developed in order to be able to natively (i.e. without temporary intermediates) read the HDF5 files written for data from the [[Eiger]] detector.		In the case of XDS, frame-reading and computation can be separated starting with version November-2016. The [https://xds.mr.mpg.de/html_doc/xds_parameters.html#LIB= LIB=] keyword allows users/companies to develop their own specialized frame-reading libraries, and relieves the XDS maintainers from implementing even more file formats. The feature was developed in order to be able to natively (i.e. without temporary intermediates) read the HDF5 files written for data from the [[Eiger]] detector.

	In the following, small examples are given for		In the following, small examples are given for

Kay: /* Existing implementations */

2022-12-05T08:29:03Z

Existing implementations

← Older revision		Revision as of 10:29, 5 December 2022
Line 688:		Line 688:
	# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors		# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors
	# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for M1 Mac is available - see [[Installation]]		# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for M1 Mac is available - see [[Installation]]
	# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file		# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file . A binary for M1 Mac is available - see [[Installation]].

			Plugins for Linux and Intel-Mac can also be obtained through [https://www.globalphasing.com/autoproc/ GPhL's autoPROC].

			See also [[Installation]].

	== See also ==		== See also ==
	# https://rosettacode.org/wiki/Call_a_function_in_a_shared_library#GNU_Fortran_on_Linux		# https://rosettacode.org/wiki/Call_a_function_in_a_shared_library#GNU_Fortran_on_Linux

Kay: /* Existing implementations */

2022-02-07T16:47:13Z

Existing implementations

← Older revision		Revision as of 18:47, 7 February 2022
Line 687:		Line 687:

	# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors		# [https://github.com/dectris/neggia Dectris Neggia-plugin] to read HDF5 written by Dectris-supplied software of Eiger detectors
	# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest		# [https://github.com/DiamondLightSource/durin Diamond's Durin-plugin] to read HDF5 written by Eiger detectors at Diamond (and presumably elsewhere); latest binaries for MacOS and Linux (RHEL6) as well as example XDS.INP and source at https://github.com/DiamondLightSource/durin/releases/latest . A binary for M1 Mac is available - see [[Installation]]
	# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file		# [https://git.embl.de/nikolova/xds-zcbf/ EMBL-Hamburg's zcbf-plugin] to read gzip-compressed CBF files without intermediate file

	== See also ==		== See also ==
	# https://rosettacode.org/wiki/Call_a_function_in_a_shared_library#GNU_Fortran_on_Linux		# https://rosettacode.org/wiki/Call_a_function_in_a_shared_library#GNU_Fortran_on_Linux

Kay: /* Glue code */ make strlen a 64bit integer !

2022-02-07T16:45:28Z

Glue code: make strlen a 64bit integer !

← Older revision		Revision as of 18:45, 7 February 2022
Line 260:		Line 260:

	interface ! strlen is a standard C function from <string.h>		interface ! strlen is a standard C function from <string.h>
	function strlen(string) result(len) bind(C,name="strlen")		integer(int64) function strlen(string) result(len) bind(C,name="strlen")
			use iso_fortran_env, only : int64
	use iso_c_binding		use iso_c_binding
	type(c_ptr), value :: string ! a C pointer		type(c_ptr), value :: string ! a C pointer

Kay: /* Client code example */ little enhancements and better comments in test_generic_client.f90 code

2021-07-26T14:52:06Z

Client code example: little enhancements and better comments in test_generic_client.f90 code

← Older revision		Revision as of 16:52, 26 July 2021
Line 122:		Line 122:
	! This reads single data files which have a header of 7680 bytes		! This reads single data files which have a header of 7680 bytes
	! Kay Diederichs 4/2017		! Kay Diederichs 4/2017
			! Kay Diederichs 7/2021 add code for the case that fn_template has no '?', and simplify&comment gfortran command.
			!
	! compile with		! compile with
	! ifort -fpic -shared -static-intel -qopenmp -traceback -sox test_generic_client.f90 -o libtest_generic_client.so		! ifort -fpic -shared -static-intel -qopenmp -qopenmp-link=static -traceback -sox test_generic_client.f90 -o libtest_generic_client.so
			! (this includes all required compiler libraries into the libtest_generic_client.so library)
	! or		! or
	! gfortran -c -fpic test_generic_client.f90 ~~&& ld~~ -shared ~~test_generic_client.o -L/usr/lib/gcc/x86_64-redhat-linux/4.8.5/ -lgfortran~~ -o libtest_generic_client.so		! gfortran -fpic test_generic_client.f90 -shared -o libtest_generic_client.so
	! (~~attention:~~ the ~~above - from "gfortran"~~ to ~~"libtest_generic_client.~~so~~" -~~ is ~~one looong line~~)		! (this does not include the compiler's libgfortran.so and libquadmath.so into the library; don't know how to achieve this so
			! gfortran is only useful if it is anyway installed on the machine)
	! The resulting file can be used with a LIB=./libtest_generic_client.so line in XDS.INP, and enables		! The resulting file can be used with a LIB=./libtest_generic_client.so line in XDS.INP, and enables
	! reading of data files with a 7680 bytes header plus 1024*1024 pixels of integer data, without any record structure.		! reading of data files with a 7680 bytes header plus 1024*1024 pixels of integer data, without any record structure.
Line 154:		Line 158:
	firstqm=INDEX(fn_template,'?')		firstqm=INDEX(fn_template,'?')
	lastqm =INDEX(fn_template,'?',BACK=.TRUE.)		lastqm =INDEX(fn_template,'?',BACK=.TRUE.)
			IF (firstqm==0) THEN
			firstqm=lenfn-7
			lastqm =lenfn-4
			END IF
	WRITE(cformat(3:5),'(i1,a1,i1)')lastqm-firstqm+1,'.',lastqm-firstqm+1		WRITE(cformat(3:5),'(i1,a1,i1)')lastqm-firstqm+1,'.',lastqm-firstqm+1
	END SUBROUTINE plugin_open		END SUBROUTINE plugin_open

Kay: /* Host code example */ fix position of -ldl in gfortran compile/link line

2021-03-03T15:25:44Z

Host code example: fix position of -ldl in gfortran compile/link line

← Older revision		Revision as of 17:25, 3 March 2021
Line 22:		Line 22:
	! ifort -qopenmp generic_data_plugin.f90 test_generic_host.f90 -o test_generic_host		! ifort -qopenmp generic_data_plugin.f90 test_generic_host.f90 -o test_generic_host
	! or		! or
	! gfortran -O -fopenmp ~~-ldl~~ generic_data_plugin.f90 test_generic_host.f90 -o test_generic_host		! gfortran -O -fopenmp generic_data_plugin.f90 test_generic_host.f90 -ldl -o test_generic_host
	! run with		! run with
	! ./test_generic_host < test.in		! ./test_generic_host < test.in

LIB - Revision history

Kay: /* Existing implementations */ same

Kay: /* Existing implementations */ explain M1 Mac better

Kay: /* Glue code */ change X*Y*DEPTH to X*Y*NBYTE

Kay: /* Client code example */ hint to -static-libgfortran and -static-libquadmath (thanks Tim Grüne)

Kay: link to documentation

Kay: /* Existing implementations */

Kay: /* Existing implementations */

Kay: /* Glue code */ make strlen a 64bit integer !

Kay: /* Client code example */ little enhancements and better comments in test_generic_client.f90 code

Kay: /* Host code example */ fix position of -ldl in gfortran compile/link line

Kay: /* Glue code / change XY*DEPTH to XYNBYTE